Method: accounts.list

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

طلب HTTP

GET https://mybusinessaccountmanagement.googleapis.com/v1/accounts

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

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

المَعلمات
parentAccount

string

اختياريّ. اسم مورد الحساب الذي سيتم استرداد قائمة الحسابات التي يمكن الوصول إليها مباشرةً من خلاله. وهذا مفيد فقط للمؤسسات ومجموعات المستخدمين. في حال ترك هذا الحقل فارغًا، سيتم عرض accounts.list للمستخدم الذي تمت مصادقته. accounts/{account_id}.
pageSize

integer

اختياريّ. عدد الحسابات المطلوب جلبها لكل صفحة. القيمة التلقائية والحد الأقصى هو 20.
pageToken

string

اختياريّ. وفي حال تحديد ذلك، يتم استرداد الصفحة التالية من الحسابات. يتم عرض pageToken عندما تؤدي استدعاء accounts.list إلى عرض نتائج أكثر مما يمكن أن يلائم حجم الصفحة المطلوب.
filter

string

اختياريّ. فلتر يقيد الحسابات للعودة. لا يتضمن الرد سوى الإدخالات التي تتطابق مع الفلتر. إذا كانت قيمة الحقل "filter" فارغة، لن يتم تطبيق أي قيود وسيتم استرداد جميع الحسابات (المقسّمة على صفحات) للحساب المطلوب.

على سبيل المثال، سيؤدي الطلب الذي يتضمّن الفلتر type=USER_GROUP إلى عرض مجموعات المستخدِمين فقط.

والحقل type هو الفلتر الوحيد المتوافق.

نص الطلب

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

نص الاستجابة

رسالة الرد لـ accounts.ListAccounts.

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

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

object (Account)

مجموعة من الحسابات التي يمكن للمستخدم الوصول إليها. سيكون الحساب الشخصي للمستخدم الذي يجري الاستعلام دائمًا هو العنصر الأول من النتيجة، ما لم تتم تصفيته.
nextPageToken

string

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

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

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

  • https://www.googleapis.com/auth/business.manage

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