REST Resource: customerUsageReports

المرجع: UsageReports

تمثيل JSON 
{
  "kind": string,
  "etag": string,
  "warnings": [
    {
      "code": string,
      "message": string,
      "data": [
        {
          "key": string,
          "value": string
        }
      ]
    }
  ],
  "usageReports": [
    {
      object (UsageReport)
    }
  ],
  "nextPageToken": string
}
الحقول
kind

string

نوع مورد واجهة برمجة التطبيقات بالنسبة إلى تقرير الاستخدام، تكون القيمة admin#reports#usageReports.
etag

string

علامة ETag للمورد.
warnings[]

object

التحذيرات، إن توفّرت
warnings[].code

string

رمز أو نوع تحذير قابل للقراءة آليًا قيمة رمز التحذير هي 200.
warnings[].message

string

في ما يلي الرسائل السهلة القراءة للتحذير:

  • تحذير بشأن عدم توفّر البيانات: لا تتوفّر بيانات التاريخ yyyy-mm-dd للطلب "application name".
  • تحذير بشأن توفُّر بيانات جزئية - بيانات التاريخ yyyy-mm-dd للتطبيق "application name" غير متاحة في الوقت الحالي، يُرجى إعادة المحاولة بعد بضع ساعات.

warnings[].data[]

object

أزواج مفاتيح وقيم لتقديم معلومات مفصّلة عن التحذير
warnings[].data[].key

string

المفتاح المرتبط بزوج المفتاح/القيمة لتقديم معلومات تفصيلية حول التحذير.
warnings[].data[].value

string

القيمة المرتبطة بزوج المفتاح/القيمة لتقديم معلومات تفصيلية حول التحذير.
usageReports[]

object (UsageReport)

سجلّات متعدّدة لمَعلمات التطبيقات
nextPageToken

string

رمز مميّز لتحديد الصفحة التالية يحتوي التقرير الذي يتضمّن صفحات متعددة على سمة nextPageToken في الاستجابة. بالنسبة إلى طلبات المتابعة التي تحصل على جميع صفحات التقرير، أدخِل القيمة nextPageToken في سلسلة طلب البحث pageToken.

UsageReport

نموذج JSON لتقرير الاستخدام

تمثيل JSON 
{
  "kind": string,
  "date": string,
  "parameters": [
    {
      "intValue": string,
      "name": string,
      "stringValue": string,
      "datetimeValue": string,
      "boolValue": boolean,
      "msgValue": [
        {
          object
        }
      ]
    }
  ],
  "etag": string,
  "entity": {
    "customerId": string,
    "userEmail": string,
    "profileId": string,
    "entityId": string,
    "type": string
  }
}
الحقول
kind

string

نوع مورد واجهة برمجة التطبيقات. بالنسبة إلى تقرير الاستخدام، تكون القيمة admin#reports#usageReport.
date

string

النتائج فقط. تاريخ طلب التقرير
parameters[]

object

النتائج فقط. أزواج قيم المَعلمة لتطبيقات مختلفة للاطّلاع على مَعلمات تقرير "استخدام العناصر" وقيَمها، راجِع مرجع مَعلمات استخدام العناصر.
parameters[].intValue

string (int64 format)

النتائج فقط. القيمة الصحيحة للمَعلمة
parameters[].name

string

اسم المَعلمة للاطّلاع على أسماء مَعلمات تقرير "استخدام المستخدِم"، يُرجى الاطّلاع على مرجع مَعلمات "استخدام المستخدِم".
parameters[].stringValue

string

النتائج فقط. قيمة سلسلة للمَعلمة.
parameters[].datetimeValue

string

القيمة بتنسيق RFC 3339 للمَعلمة، على سبيل المثال 2010-10-28T10:26:35.000Z.
parameters[].boolValue

boolean

النتائج فقط. القيمة المنطقية للمعلَمة.
parameters[].msgValue[]

object (Struct format)

النتائج فقط. قيمة الرسالة المتداخلة للمَعلمة.
etag

string

علامة ETag للمورد
entity

object

النتائج فقط. معلومات عن نوع العنصر
entity.customerId

string

النتائج فقط. المعرّف الفريد لحساب العميل.
entity.userEmail

string

النتائج فقط. عنوان البريد الإلكتروني للمستخدِم. لا ينطبق إلا إذا كان entity.type = "USER"
entity.profileId

string

النتائج فقط. معرّف الملف الشخصي غير القابل للتغيير للمستخدم على Google Workspace
entity.entityId

string

النتائج فقط. مفتاح العنصر لا ينطبق إلا إذا كان نوع العنصر entity.type = "كائن". ملاحظة: اسم التقرير الموجَّه للجهات الخارجية هو "العناصر" بدلاً من "الكائنات".
entity.type

string

النتائج فقط. نوع العنصر القيمة هي user.

الطُرق

get

 يسترجع تقريرًا يمثّل مجموعة من المواقع والإحصاءات لحساب عميل معيّن.