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

النتائج فقط. الحدّ الأقصى لعدد العروض الترويجية المطلوب عرضها قد تعرض الخدمة عددًا أقل من هذه القيمة. الحد الأقصى للقيمة هو 250، وسيتم تحويل القيم التي تزيد عن 250 إلى 250. وفي حال عدم تحديد قيمة هذه السمة، سيتم عرض الحدّ الأقصى لعدد العروض الترويجية.
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.