REST Resource: package

מקור מידע: חבילה

משאב package מייצג קבוצה של קבצים שמועברים דרך האינטרנט, SFTP או מנגנון העברה אחר. בשלב הזה, ה-API תומך בהעלאת חבילה שמכילה בדיוק קובץ מטא-נתונים אחד, או באחזור מידע על חבילה שהועלתה בעבר.

ייצוג JSON 
{
  "kind": string,
  "uploaderName": string,
  "content": string,
  "locale": string,
  "customIds": [
    string
  ],
  "name": string,
  "type": string,
  "timeCreated": string,
  "status": string,
  "statusReports": [
    {
      object (StatusReport)
    }
  ],
  "id": string
}
שדות
kind

string

סוג משאב ה-API. במשאבי package, הערך הזה הוא youtubePartner#package.
uploaderName

string

השם של מעלה התוכן.
content

string

התוכן של קובץ המטא-נתונים של החבילה.
locale

string

הלוקאל הרצוי של הודעות השגיאה, כפי שמוגדר ב-BCP 47 ‏ (http: //tools.ietf.org/html/bcp47). לדוגמה, 'en-US' או 'de'. אם לא מציינים שפה, הודעות השגיאה יוחזרו באנגלית (en).
customIds[]

string

רשימת מספרי הלקוחות.
name

string

שם החבילה.
type

string

סוג החבילה. ערכים קבילים:

  • ‫Art Track – החבילה מכילה מטא-נתונים ומדיה של תמונות רקע.
  • ‫Composition – החבילה מכילה מטא-נתונים של יצירות.
  • ‫Movie – החבילה מכילה מטא-נתונים ומדיה של סרט.
  • ‫Music Video – החבילה מכילה מטא-נתונים ומדיה של קליפים.
  • ‫Sound Recording – החבילה מכילה מטא-נתונים של הקלטת אודיו.
  • ‫TV Episode – החבילה מכילה מטא-נתונים ומדיה של פרק בתוכנית טלוויזיה.
  • ‫Unknown media type – סוג המדיה של החבילה לא ידוע.
  • ‫Web – החבילה מכילה מטא-נתונים ומדיה של סרטוני אינטרנט.
timeCreated

string

הזמן שבו החבילה נוצרה. הערך מצוין בפורמט RFC 3339 (YYYY-MM-DDThh:mm:ss.000Z).
status

string

סטטוס החבילה. ערכים קבילים:

  • ‫Draft – המערכת מכינה את המטא-נתונים של החבילה.
  • ‫Errors – החבילה נכשלה באימות או בעיבוד.
  • ‫Processing – החבילה נמצאת כרגע בתהליך עיבוד.
  • ‫Successful – החבילה עובדה בהצלחה.
  • ‫Unknown status – סטטוס החבילה לא ידוע.
statusReports[]

object (StatusReport)

סטטוס החבילה מדווח.
id

string

מזהה ש-YouTube מקצה ומשתמש בו כדי לזהות את החבילה באופן ייחודי.

StatusReport

האובייקט הזה מכיל מידע שמתאר את המקור של דוח סטטוס החבילה.

ייצוג JSON 
{
  "statusContent": string,
  "statusFileName": string
}
שדות
statusContent

string

התוכן של הודעת הדיווח. המאפיין הזה משמש רק ב-Hybrid.
statusFileName

string

שם קובץ הסטטוס. המאפיין הזה משמש רק ב-Hybrid.

Methods

get

 אחזור מידע על החבילה שצוינה.

insert

 הוספת חבילה של מטא-נתונים בלבד.