Method: accounts.products.list

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

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

طلب HTTP

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

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

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

المعلمات
parent

string

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

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

المعلمات
pageSize

integer

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

string

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

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

نص الطلب

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

نص الاستجابة

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

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

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

object (Product)

المنتجات التي تمت معالجتها من الحساب المحدّد هذه هي منتجاتك التي تمت معالجتها بعد تطبيق القواعد ومصادر البيانات التكميلية.
nextPageToken

string

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

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

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

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

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