Method: properties.getMetadata

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

على سبيل المثال، إذا تم تسجيل مقياس مخصّص باسم المعلَمة levels_unlocked في موقع، ستحتوي استجابة البيانات الوصفية على customEvent:levels_unlocked. البيانات الوصفية العامة هي سمات ومقاييس سارية على أي موقع، مثل country وtotalUsers.

طلب HTTP

GET https://analyticsdata.googleapis.com/v1beta/{name=properties/*/metadata}

يستخدم عنوان URL بنية gRPC Transcoding.

معلّمات المسار

المَعلمات
name

string

مطلوبة. اسم مورد البيانات الوصفية المطلوب استردادها. يتم تحديد حقل الاسم هذا في مسار عنوان URL، وليس في معلمات عنوان URL. الموقع هو معرّف رقمي على "إحصاءات Google" 4. ولمزيد من المعلومات، اطّلِع على مكان العثور على رقم تعريف موقعك.

مثال: الخصائص/1234/البيانات الوصفية

يمكنك ضبط رقم تعريف الموقع على 0 للمكوّنات والمقاييس الشائعة لجميع المواقع. في هذا الوضع الخاص، لن تعرِض هذه الطريقة المكوّنات والمقاييس المخصّصة.

نص الطلب

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

نص الاستجابة

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

الأبعاد والمقاييس المقبولة حاليًا في طرق إعداد التقارير.

تمثيل JSON 
{
  "name": string,
  "dimensions": [
    {
      object (DimensionMetadata)
    }
  ],
  "metrics": [
    {
      object (MetricMetadata)
    }
  ]
}
الحقول
name

string

اسم المورد لهذه البيانات الوصفية.
dimensions[]

object (DimensionMetadata)

أوصاف السمات.
metrics[]

object (MetricMetadata)

أوصاف المقاييس.

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

يتطلّب أحد نطاقات OAuth التالية:

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