Method: accounts.locations.media.list

تعرض قائمة بملفات الوسائط المرتبطة بموقع جغرافي.

طلب HTTP

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

يستخدِم عنوان URL بنية تحويل ترميز gRPC.

مَعلمات المسار

المَعلمات
parent

string

اسم الموقع الجغرافي الذي سيتم سرد عناصر الوسائط الخاصة به.

معلمات طلب البحث

المَعلمات
pageSize

integer

عدد عناصر الوسائط المطلوب عرضها في كل صفحة. القيمة التلقائية هي 100، وهي أيضًا أقصى عدد مسموح به من عناصر الوسائط التي يمكن إضافتها إلى موقع جغرافي باستخدام واجهة برمجة تطبيقات "نشاطي التجاري على Google". الحد الأقصى لحجم الصفحة هو 2,500.
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.