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)

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