Method: accountSummaries.list

تعرض هذه الطريقة ملخّصات لجميع الحسابات التي يمكن للمتصل الوصول إليها.

طلب HTTP

GET https://analyticsadmin.googleapis.com/v1beta/accountSummaries

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

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

المعلمات
pageSize

integer

اختياريّ. الحد الأقصى لعدد موارد AccountSummary التي سيتم عرضها. قد تعرض الخدمة عددًا أقل من هذا القيمة، حتى إذا كانت هناك صفحات إضافية. إذا لم يتم تحديد هذه القيمة، سيتم عرض 50 موردًا على الأكثر. القيمة القصوى هي 200 (وسيتم فرض القيمة القصوى على القيم الأعلى)
pageToken

string

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

نص الطلب

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

نص الاستجابة

رسالة الاستجابة لاستدعاء إجراء accountSummaries.list عن بُعد (RPC)

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

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

object (AccountSummary)

ملخّصات الحسابات لجميع الحسابات التي يمكن للمتصل الوصول إليها
nextPageToken

string

رمز يمكن إرساله كـ pageToken لاسترداد الصفحة التالية إذا تم حذف هذا الحقل، ما يعني أنّه ما مِن صفحات لاحقة

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

يجب توفير أحد نطاقات OAuth التالية:

  • https://www.googleapis.com/auth/analytics.readonly
  • https://www.googleapis.com/auth/analytics.edit

AccountSummary

مورد افتراضي يمثّل نظرة عامة على حساب وجميع مواقع "إحصاءات Google" الفرعية التابعة له

تمثيل JSON 
{
  "name": string,
  "account": string,
  "displayName": string,
  "propertySummaries": [
    {
      object (PropertySummary)
    }
  ]
}
الحقول
name

string

المعرّف. اسم مورد ملخّص الحساب هذا التنسيق: accountSummaries/{account_id} مثال: "accountSummaries/1000"
account

string

اسم مورد الحساب الذي يشير إليه ملخّص الحساب هذا التنسيق: accounts/{account_id} مثال: "accounts/1000"
displayName

string

الاسم المعروض للحساب المشار إليه في ملخّص الحساب هذا
propertySummaries[]

object (PropertySummary)

قائمة بملخّصات الحسابات الفرعية لهذا الحساب

PropertySummary

مورد افتراضي يمثّل بيانات وصفية لموقع على "إحصاءات Google"

تمثيل JSON 
{
  "property": string,
  "displayName": string,
  "propertyType": enum (PropertyType),
  "parent": string,
  "canEdit": boolean
}
الحقول
property

string

اسم مورد الموقع الذي يشير إليه ملخّص الموقع هذا التنسيق: properties/{property_id} مثال: "properties/1000"
displayName

string

الاسم المعروض للموقع المشار إليه في ملخّص الموقع هذا
propertyType

enum (PropertyType)

نوع الموقع
parent

string

اسم مورد الموقع الرئيسي المنطقي لهذا الموقع

ملاحظة: يمكن استخدام واجهة مستخدم نقل المواقع لتغيير الموقع الرئيسي. التنسيق: accounts/{account}، properties/{property} مثال: "accounts/100"، "properties/200"
canEdit

boolean

إذا كانت القيمة true، يعني ذلك أنّ لدى المستخدِم دورًا في "إحصاءات Google" يسمح له بتعديل الموقع.