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.