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.