Method: accounts.promotions.list

يسرد العروض الترويجية في حسابك على Merchant Center. قد يحتوي الرد على عناصر أقل مما تم تحديده من قِبل "pageSize". يمكنك الاعتماد على pageToken لتحديد ما إذا كانت هناك عناصر أخرى مطلوب طلبها.

بعد إدراج عرض ترويجي أو تعديله، قد يستغرق استرداد العرض الترويجي الذي تمت معالجته عدة دقائق.

طلب HTTP

GET https://merchantapi.googleapis.com/promotions/v1beta/{parent=accounts/*}/promotions

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

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

المعلمات
parent

string

مطلوبة. الحساب المطلوب إدراج عروض ترويجية تمت معالجتها له تنسيق الملف: accounts/{account}

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

المعلمات
pageSize

integer

النتائج فقط. الحدّ الأقصى لعدد العروض الترويجية المطلوب عرضها قد تعرض الخدمة عددًا أقل من هذه القيمة. الحد الأقصى للقيمة هي 1000، وسيتم فرض القيم الأعلى من 1000 على 1000. وفي حال عدم تحديد قيمة هذه السمة، سيتم عرض الحدّ الأقصى لعدد العروض الترويجية.
pageToken

string

النتائج فقط. رمز مميّز للصفحة، تم تلقّيه من استدعاء سابق لتطبيق "promotions.list". ويمكنك توفير هذا الحقل لاسترداد الصفحة التالية.

عند التقسيم على صفحات، يجب أن تتطابق جميع المَعلمات الأخرى المقدَّمة إلى promotions.list مع الاستدعاء الذي قدّم الرمز المميّز للصفحة.

نص الطلب

يجب أن يكون نص الطلب فارغًا.

نص الاستجابة

رسالة الردّ على طريقة promotions.list

إذا كانت الاستجابة ناجحة، سيحتوي نص الاستجابة على بيانات بالبنية التالية:

تمثيل JSON 
{
  "promotions": [
    {
      object (Promotion)
    }
  ],
  "nextPageToken": string
}
الحقول
promotions[]

object (Promotion)

العروض الترويجية التي تمت معالجتها من الحساب المحدّد.
nextPageToken

string

رمز مميز يمكن إرساله على شكل pageToken لاسترداد الصفحة التالية. في حال إسقاط هذا الحقل، لن تظهر أي صفحات لاحقة.

نطاقات الأذونات

يجب توفير نطاق OAuth التالي:

  • https://www.googleapis.com/auth/content

لمزيد من المعلومات، يُرجى الاطِّلاع على نظرة عامة على OAuth 2.0.