يسرد العروض الترويجية في حسابك على Merchant Center. قد يحتوي الرد على عناصر أقل مما تم تحديده من قِبل "pageSize
". يمكنك الاعتماد على pageToken
لتحديد ما إذا كانت هناك عناصر أخرى مطلوب طلبها.
بعد إدراج عرض ترويجي أو تعديله، قد يستغرق استرداد العرض الترويجي الذي تمت معالجته عدة دقائق.
طلب HTTP
GET https://merchantapi.googleapis.com/promotions/v1beta/{parent=accounts/*}/promotions
يستخدِم عنوان URL بنية تحويل ترميز gRPC.
مَعلمات المسار
المعلمات | |
---|---|
parent |
مطلوب. الحساب المطلوب إدراج عروض ترويجية تمت معالجتها له تنسيق الملف: |
معامِلات طلب البحث
المعلمات | |
---|---|
pageSize |
النتائج فقط. الحدّ الأقصى لعدد العروض الترويجية المطلوب عرضها قد تعرض الخدمة عددًا أقل من هذه القيمة. الحد الأقصى للقيمة هو 1000؛ سيتم فرض القيم الأكبر من 1000 على 1000. وفي حال عدم تحديد قيمة هذه السمة، سيتم إرجاع الحد الأقصى لعدد العروض الترويجية. |
pageToken |
النتائج فقط. رمز مميّز للصفحة، تم تلقّيه من استدعاء سابق لتطبيق " عند التقسيم على صفحات، يجب أن تتطابق جميع المَعلمات الأخرى المقدَّمة إلى |
نص الطلب
يجب أن يكون نص الطلب فارغًا.
نص الاستجابة
رسالة الردّ على الطريقة promotions.list
إذا كانت الاستجابة ناجحة، سيحتوي نص الاستجابة على بيانات بالبنية التالية:
تمثيل JSON |
---|
{
"promotions": [
{
object ( |
الحقول | |
---|---|
promotions[] |
العروض الترويجية التي تمت معالجتها من الحساب المحدّد. |
nextPageToken |
رمز مميز يمكن إرساله على شكل |
نطاقات الأذونات
يجب توفير نطاق OAuth التالي:
https://www.googleapis.com/auth/content
لمزيد من المعلومات، يُرجى الاطِّلاع على نظرة عامة على OAuth 2.0.