REST Resource: package

Zasób: Package

package Zasób to grupa plików dostarczanych przez internet, SFTP lub inny mechanizm dostarczania. Interfejs API umożliwia obecnie przesyłanie pakietu zawierającego dokładnie 1 plik metadanych lub pobieranie informacji o wcześniej przesłanym pakiecie.

Zapis JSON
{
  "kind": string,
  "uploaderName": string,
  "content": string,
  "locale": string,
  "customIds": [
    string
  ],
  "name": string,
  "type": string,
  "timeCreated": string,
  "status": string,
  "statusReports": [
    {
      object (StatusReport)
    }
  ],
  "id": string
}
Pola
kind

string

Typ zasobu interfejsu API. W przypadku zasobów package ta wartość to youtubePartner#package.

uploaderName

string

Nazwa przesyłającego.

content

string

Zawartość pliku metadanych pakietu.

locale

string

Żądany język komunikatów o błędach zdefiniowany w BCP 47 (http: //tools.ietf.org/html/bcp47). np. „en-US” lub „de”. Jeśli nie zostanie określony, zwrócimy komunikaty o błędach w języku angielskim („en”).

customIds[]

string

Lista identyfikatorów klientów.

name

string

Nazwa pakietu.

type

string

Typ pakietu. Akceptowane wartości:

  • Art Track – pakiet zawiera metadane i media utworu audio.
  • Composition – pakiet zawiera metadane kompozycji.
  • Movie – pakiet zawiera metadane filmu i multimedia.
  • Music Video – pakiet zawiera metadane i multimedia teledysku.
  • Sound Recording – pakiet zawiera metadane nagrania dźwiękowego.
  • TV Episode – pakiet zawiera metadane i multimedia odcinka programu telewizyjnego.
  • Unknown media type – typ multimediów pakietu jest nieznany.
  • Web – pakiet zawiera metadane i media wideo w internecie.
timeCreated

string

Czas utworzenia pakietu. Wartość jest podana w formacie RFC 3339 (YYYY-MM-DDThh:mm:ss.000Z).

status

string

Stan pakietu. Akceptowane wartości:

  • Draft – przygotowywanie metadanych pakietu.
  • Errors – nie udało się zweryfikować lub przetworzyć pakietu.
  • Processing – pakiet jest obecnie przetwarzany.
  • Successful – pakiet został przetworzony.
  • Unknown status – stan pakietu jest nieznany.
statusReports[]

object (StatusReport)

Raporty o stanie pakietu.

id

string

Identyfikator przypisany przez YouTube, który jest używany do jednoznacznego identyfikowania pakietu.

StatusReport

Ten obiekt zawiera informacje opisujące źródło raportu o stanie przesyłki.

Zapis JSON
{
  "statusContent": string,
  "statusFileName": string
}
Pola
statusContent

string

Treść wiadomości raportu. Używany tylko w przypadku hybrydowego wstawiania reklam.

statusFileName

string

Nazwa pliku stanu. Używany tylko w przypadku hybrydowego wstawiania reklam.

Metody

get

Pobiera informacje o określonym pakiecie.

insert

Wstawia pakiet zawierający tylko metadane.