Method: accounts.locations.media.list

فهرستی از موارد رسانه مرتبط با یک مکان را برمی‌گرداند.

درخواست HTTP

GET https://mybusiness.googleapis.com/v4/{parent=accounts/*/locations/*}/media

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

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

پارامترها
parent

string

نام مکانی که آیتم های رسانه ای آن لیست می شود.

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

پارامترها
pageSize

integer

تعداد آیتم های رسانه ای برای بازگرداندن در هر صفحه. مقدار پیش‌فرض 100 است، که همچنین حداکثر تعداد موارد رسانه‌ای است که می‌توان با Google My Business API به یک مکان اضافه کرد. حداکثر اندازه صفحه 2500 است.

pageToken

string

در صورت مشخص شدن، صفحه بعدی موارد رسانه را برمی گرداند.

درخواست بدن

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

بدن پاسخگو

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

پیام پاسخ برای Media.ListMediaItems.

نمایندگی JSON 
{
  "mediaItems": [
    {
      object (MediaItem)
    }
  ],
  "totalMediaItemCount": integer,
  "nextPageToken": string
}
فیلدها
mediaItems[]

object ( MediaItem )

لیست بازگردانده شده از آیتم های رسانه.

totalMediaItemCount

integer

تعداد کل موارد رسانه ای برای این مکان، صرف نظر از صفحه بندی.

nextPageToken

string

اگر موارد رسانه‌ای بیش از اندازه صفحه درخواستی وجود داشته باشد، این فیلد با نشانه‌ای پر می‌شود تا صفحه بعدی آیتم‌های رسانه را در تماس بعدی با media.list واکشی کند.

محدوده مجوز

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

  • https://www.googleapis.com/auth/plus.business.manage
  • https://www.googleapis.com/auth/business.manage

برای اطلاعات بیشتر، به نمای کلی OAuth 2.0 مراجعه کنید.