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 Overview.