Method: mediaItems.batchCreate

יצירת פריט מדיה אחד או יותר בספריית Google Photos של המשתמש.

זהו השלב השני ביצירת פריט מדיה. לפרטים לגבי שלב 1, העלאת הבייטים הגולמיים לשרת Google, אפשר לעיין במאמר העלאת מדיה.

השיחה הזו גורמת להוספה של קובץ המדיה לספרייה. אם מציינים אלבום id, השיחה מוסיפה גם את פריט המדיה לאלבום. כל אלבום יכול להכיל עד 20,000 פריטי מדיה. כברירת מחדל, פריט המדיה יתווסף לסוף הספרייה או האלבום.

אם מוגדרים גם id וגם מיקום, פריט המדיה יתווסף לאלבום במיקום שצוין.

אם השיחה מכילה כמה פריטי מדיה, הם יתווספו במיקום שצוין. אם אתם יוצרים פריט מדיה באלבום משותף שאתם לא הבעלים שלו, אין לכם אפשרות למקם את פריט המדיה. אם תנסו לעשות את זה תוצג לכם הודעת שגיאה מסוג BAD REQUEST.

בקשת HTTP

POST https://photoslibrary.googleapis.com/v1/mediaItems:batchCreate

בכתובת ה-URL נעשה שימוש בתחביר המרת קידוד של gRPC.

גוף הבקשה

גוף הבקשה מכיל נתונים במבנה הבא:

ייצוג ב-JSON 
{
  "albumId": string,
  "newMediaItems": [
    {
      object (NewMediaItem)
    }
  ],
  "albumPosition": {
    object (AlbumPosition)
  }
}
שדות
albumId

string

המזהה של האלבום שאליו נוספו פריטי המדיה. פריטי המדיה מתווספים גם לספרייה של המשתמש. השדה הזה אופציונלי.
newMediaItems[]

object (NewMediaItem)

חובה. רשימת פריטי מדיה ליצירה. עד 50 פריטי מדיה לשיחה.
albumPosition

object (AlbumPosition)

המיקום באלבום שבו נוספו פריטי המדיה. אם לא מציינים זאת, פריטי המדיה יתווספו לסוף האלבום (בהתאם לערך ברירת המחדל, כלומר LAST_IN_ALBUM). הבקשה תיכשל אם השדה הזה מוגדר וה-albumId לא יצוין. אם אתם לא הבעלים של האלבום המשותף, הבקשה תיכשל גם אם תגדירו את השדה.

גוף התשובה

רשימת קובצי המדיה נוצרה.

אם הפעולה מצליחה, גוף התגובה מכיל נתונים במבנה הבא:

ייצוג JSON 
{
  "newMediaItemResults": [
    {
      object (NewMediaItemResult)
    }
  ]
}
שדות
newMediaItemResults[]

object (NewMediaItemResult)

פלט בלבד. רשימת קובצי המדיה נוצרה.

היקפי ההרשאות

נדרש אחד מהיקפי ההרשאות הבאים של OAuth:

  • https://www.googleapis.com/auth/photoslibrary
  • https://www.googleapis.com/auth/photoslibrary.appendonly
  • https://www.googleapis.com/auth/photoslibrary.sharing

NewMediaItem

פריט מדיה חדש שנוצר בחשבון של משתמש ב-Google Photos.

ייצוג ב-JSON 
{
  "description": string,

  // Union field new_media_item_type can be only one of the following:
  "simpleMediaItem": {
    object (SimpleMediaItem)
  }
  // End of list of possible types for union field new_media_item_type.
}
שדות
description

string

התיאור של פריט המדיה. השם הזה מוצג למשתמש בקטע המידע של הפריט באפליקציית Google Photos. אורכו צריך להיות פחות מ-1,000 תווים. יש לכלול רק טקסט שנכתב על ידי משתמשים. התיאורים צריכים להוסיף הקשר ולעזור למשתמשים להבין את המדיה. אין לכלול מחרוזות שנוצרות באופן אוטומטי, כמו שמות קבצים, תגים ומטא-נתונים אחרים.
שדה איחוד new_media_item_type. פריט המדיה החדש יכול להיות מסוגים שונים – הדבר תלוי בנתיב ההעלאה. בהעלאות שנתמכות כרגע נעשה שימוש רק בנתיב פריט המדיה הפשוט. הערך של new_media_item_type יכול להיות רק אחת מהאפשרויות הבאות:
simpleMediaItem

object (SimpleMediaItem)

פריט מדיה חדש שהועלה באמצעות uploadToken הכלול.

SimpleMediaItem

פריט מדיה פשוט שייווצר ב-Google Photos באמצעות אסימון העלאה.

ייצוג JSON 
{
  "uploadToken": string,
  "fileName": string
}
שדות
uploadToken

string

אסימון שמזהה את הבייטים של המדיה שהועלו ל-Google.
fileName

string

שם הקובץ עם הסיומת של פריט המדיה. השם הזה מוצג למשתמש ב-Google Photos. אם השדה הזה מוגדר, המערכת מתעלמת משם הקובץ שצוין במהלך תהליך ההעלאה של בייטים. שם הקובץ, כולל סיומת הקובץ, צריך להיות באורך של עד 255 תווים. השדה הזה אופציונלי.

NewMediaItemResult

התוצאה של יצירת פריט מדיה חדש.

ייצוג JSON 
{
  "uploadToken": string,
  "status": {
    object (Status)
  },
  "mediaItem": {
    object (MediaItem)
  }
}
שדות
uploadToken

string

אסימון ההעלאה ששימש ליצירת פריט המדיה החדש (הפשוט). השדה הזה מאוכלס רק אם פריט המדיה פשוט ונדרש אסימון העלאה יחיד.
status

object (Status)

אם אירעה שגיאה במהלך היצירה של פריט המדיה הזה, השדה הזה יאוכלס במידע שקשור לשגיאה. לפרטים לגבי השדה הזה, ראו סטטוס.
mediaItem

object (MediaItem)

פריט המדיה נוצר באמצעות אסימון ההעלאה. הוא מאוכלס אם לא אירעו שגיאות ופריט המדיה נוצר בהצלחה.