Method: mediaItems.batchGet

لیستی از آیتم های رسانه را برای شناسه های آیتم رسانه ای مشخص شده برمی گرداند. اقلام به همان ترتیبی که شناسه های ارائه شده برگردانده می شوند.

درخواست HTTP

GET https://photoslibrary.googleapis.com/v1/mediaItems:batchGet

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

پارامترهای پرس و جو

پارامترها
mediaItemIds[]

string

مورد نیاز. شناسه اقلام رسانه ای که باید درخواست شود. نباید دارای شناسه های مکرر باشد و نمی تواند خالی باشد. حداکثر تعداد آیتم های رسانه ای قابل بازیابی در یک تماس 50 عدد است.

درخواست بدن

بدنه درخواست باید خالی باشد.

بدن پاسخگو

پاسخ برای بازیابی لیستی از آیتم های رسانه.

در صورت موفقیت آمیز بودن، بدنه پاسخ حاوی داده هایی با ساختار زیر است:

نمایندگی JSON 
{
  "mediaItemResults": [
    {
      object (MediaItemResult)
    }
  ]
}
فیلدها
mediaItemResults[]

object ( MediaItemResult )

فقط خروجی فهرست موارد رسانه بازیابی شده توجه داشته باشید که حتی اگر تماس با mediaItems.batchGet موفقیت آمیز باشد، ممکن است برای برخی از آیتم های رسانه ای در دسته با شکست مواجه شده باشد. این خرابی ها در هر MediaItemResult.status نشان داده شده است.

محدوده مجوز

به یکی از حوزه های OAuth زیر نیاز دارد:

  • https://www.googleapis.com/auth/photoslibrary
  • https://www.googleapis.com/auth/photoslibrary.readonly
  • https://www.googleapis.com/auth/photoslibrary.readonly.appcreateddata
  • https://www.googleapis.com/auth/photoslibrary.readonly.originals

MediaItemResult

نتیجه بازیابی یک آیتم رسانه ای.

نمایندگی JSON 
{
  "status": {
    object (Status)
  },
  "mediaItem": {
    object (MediaItem)
  }
}
فیلدها
status

object ( Status )

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

mediaItem

object ( MediaItem )

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