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.