Method: mediaItems.batchCreate

یک یا چند مورد رسانه ای را در کتابخانه Google Photos کاربر ایجاد می کند.

این مرحله دوم برای ایجاد یک آیتم رسانه ای است. برای جزئیات مربوط به مرحله 1، آپلود بایت های خام در یک سرور Google، به آپلود رسانه مراجعه کنید.

این تماس آیتم رسانه ای را به کتابخانه اضافه می کند. اگر id آلبوم مشخص شده باشد، تماس مورد رسانه را نیز به آلبوم اضافه می کند. هر آلبوم می تواند حداکثر 20000 آیتم رسانه ای داشته باشد. به طور پیش فرض، آیتم رسانه به انتهای کتابخانه یا آلبوم اضافه می شود.

اگر id و موقعیت آلبوم هر دو تعریف شده باشند، آیتم رسانه در موقعیت مشخص شده به آلبوم اضافه می شود.

اگر تماس حاوی چندین آیتم رسانه ای باشد، آنها در موقعیت مشخص شده اضافه می شوند. اگر در حال ایجاد یک مورد رسانه در یک آلبوم مشترک هستید که مالک آن نیستید، مجاز نیستید مورد رسانه را در موقعیت مکانی قرار دهید. انجام این کار منجر به خطای BAD REQUEST می شود.

درخواست HTTP

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

URL از دستور GRPC Transcoding استفاده می کند.

درخواست بدن

بدنه درخواست حاوی داده هایی با ساختار زیر است:

نمایندگی 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 به کاربر نشان داده می شود. باید کمتر از 1000 کاراکتر باشد. فقط شامل متن نوشته شده توسط کاربران باشد. توضیحات باید زمینه اضافه کنند و به کاربران در درک رسانه کمک کنند. رشته های تولید شده به صورت خودکار مانند نام فایل ها، برچسب ها و سایر ابرداده ها را وارد نکنید.

فیلد اتحادیه 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 )

مورد رسانه با رمز آپلود ایجاد شد. اگر خطایی رخ نداده باشد و مورد رسانه با موفقیت ایجاد شود، پر می شود.