Method: properties.getMetadata

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

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

طلب HTTP

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

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

مَعلمات المسار

المَعلمات
name

string

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

مثال: properties/1234/metadata

اضبط رقم تعريف الموقع على 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