Method: accounts.listSubaccounts

أدرِج كل الحسابات الفرعية لحساب متعدّد العملاء معيّن. هو برنامج تضمين مريح لطريقة accounts.list الأكثر فعالية. ستُنتج هذه الطريقة النتائج نفسها الناتجة عن استدعاء ListsAccounts باستخدام الفلتر التالي: relationship(providerId={parent} AND service(type="ACCOUNT_AGGREGATION"))

طلب HTTP

GET https://merchantapi.googleapis.com/accounts/v1beta/{provider=accounts/*}:listSubaccounts

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

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

المعلمات
provider

string

مطلوبة. الحساب الرئيسي تنسيق الملف: accounts/{account}

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

المعلمات
pageSize

integer

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

string

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

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

نص الطلب

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

نص الاستجابة

رسالة الردّ على طريقة accounts.listSubaccounts

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

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

object (Account)

الحسابات التي يكون الحساب الرئيسي المحدّد لها مجمّع سلع
nextPageToken

string

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

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

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

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

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