Method: accounts.list

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

طلب HTTP

GET https://merchantapi.googleapis.com/accounts/v1beta/accounts

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

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

المعلمات
pageSize

integer

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

string

اختيارية: رمز مميّز للصفحة، تم تلقّيه من مكالمة accounts.list سابقة قدِّم هذا المرجع لاسترداد الصفحة اللاحقة.

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

string

اختيارية: لا تعرض سوى الحسابات التي تتطابق مع الفلتر. لمزيد من التفاصيل، راجِع مرجع بنية الفلتر.

نص الطلب

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

نص الاستجابة

رسالة الردّ لطريقة accounts.list

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

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

object (Account)

الحسابات التي تتطابق مع ListAccountsRequest
nextPageToken

string

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

نطاقات التفويض

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

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

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