Package google.analytics.admin.v1beta

الفهرس

AnalyticsAdminService

واجهة الخدمة لواجهة Google Analytics Admin API

AcknowledgeUserDataCollection

rpc AcknowledgeUserDataCollection(AcknowledgeUserDataCollectionRequest) returns (AcknowledgeUserDataCollectionResponse)

يقرّ بشروط جمع بيانات المستخدمين للموقع المحدّد.

يجب إكمال هذا الإقرار (إمّا في واجهة مستخدم "إحصاءات Google" أو من خلال واجهة برمجة التطبيقات هذه) قبل إنشاء موارد MeasurementProtocolSecret.

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

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

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

rpc ArchiveCustomDimension(ArchiveCustomDimensionRequest) returns (Empty)

تؤرشف هذه السمة CustomDimension في موقع.

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

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

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

rpc ArchiveCustomMetric(ArchiveCustomMetricRequest) returns (Empty)

تؤرشف هذه الطريقة مقياسًا مخصّصًا في موقع.

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

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

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

rpc CreateConversionEvent(CreateConversionEventRequest) returns (ConversionEvent)

تم إيقاف هذه السياسة نهائيًا، لذا يُرجى استخدام سياسة CreateKeyEvent بدلاً منها. تنشئ هذه الطريقة حدث إحالة ناجحة بالسمات المحدّدة.

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

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

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

rpc CreateCustomDimension(CreateCustomDimensionRequest) returns (CustomDimension)

تنشئ هذه الطريقة CustomDimension.

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

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

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

rpc CreateCustomMetric(CreateCustomMetricRequest) returns (CustomMetric)

تنشئ هذه الطريقة CustomMetric.

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

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

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

rpc CreateDataStream(CreateDataStreamRequest) returns (DataStream)

تنشئ هذه الطريقة DataStream.

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

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

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

rpc CreateKeyEvent(CreateKeyEventRequest) returns (KeyEvent)

تُنشئ هذه السمة حدثًا رئيسيًا.

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

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

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

rpc CreateMeasurementProtocolSecret(CreateMeasurementProtocolSecretRequest) returns (MeasurementProtocolSecret)

تنشئ هذه الطريقة سرّ Measurement Protocol.

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

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

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

rpc CreateProperty(CreatePropertyRequest) returns (Property)

تنشئ هذه الطريقة موقعًا على "إحصاءات Google" بالموقع الجغرافي والسمات المحدّدة.

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

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

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

rpc DeleteAccount(DeleteAccountRequest) returns (Empty)

يضع علامة على الحساب المستهدَف على أنّه محذوف بشكلٍ مبدئي (أي "تم نقله إلى المهملات") ويعيده.

لا تتضمّن واجهة برمجة التطبيقات هذه طريقة لاستعادة الحسابات المحذوفة مؤقتًا. ومع ذلك، يمكن استعادتها باستخدام واجهة مستخدم "سلة المهملات".

في حال عدم استعادة الحسابات قبل انتهاء وقت انتهاء الصلاحية، سيتم حذف الحساب وجميع موارد الحسابات الفرعية (مثل المواقع، وGoogleAdsLinks، وStreams، وAccessBindings) نهائيًا. https://support.google.com/analytics/answer/6154772

تعرض هذه الطريقة رسالة خطأ إذا لم يتم العثور على الهدف.

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

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

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

rpc DeleteConversionEvent(DeleteConversionEventRequest) returns (Empty)

تم إيقاف هذه السياسة نهائيًا، لذا يُرجى استخدام سياسة DeleteKeyEvent بدلاً منها. تحذف هذه الطريقة حدث إحالة ناجحة في موقع.

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

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

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

rpc DeleteDataStream(DeleteDataStreamRequest) returns (Empty)

تحذف هذه الطريقة مصدر بيانات في موقع.

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

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

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

rpc DeleteKeyEvent(DeleteKeyEventRequest) returns (Empty)

لحذف حدث رئيسي

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

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

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

rpc DeleteMeasurementProtocolSecret(DeleteMeasurementProtocolSecretRequest) returns (Empty)

تحذف هذه الطريقة MeasurementProtocolSecret المستهدَف.

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

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

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

rpc DeleteProperty(DeletePropertyRequest) returns (Property)

يضع علامة على السمة المستهدَفة على أنّها محذوفة بشكلٍ مبدئي (أي "نُقلت إلى المهملات") ويعرضها.

لا تتضمّن واجهة برمجة التطبيقات هذه طريقة لاستعادة المواقع المحذوفة مؤقتًا. ومع ذلك، يمكن استعادتها باستخدام واجهة مستخدم "سلة المهملات".

إذا لم يتم استعادة المواقع قبل وقت انتهاء الصلاحية، سيتم إزالة الموقع وجميع الموارد الفرعية (مثل GoogleAdsLinks وStreams وAccessBindings) نهائيًا. https://support.google.com/analytics/answer/6154772

تعرض هذه الطريقة رسالة خطأ إذا لم يتم العثور على الهدف.

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

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

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

rpc GetAccount(GetAccountRequest) returns (Account)

البحث عن حساب واحد

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

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

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

rpc GetConversionEvent(GetConversionEventRequest) returns (ConversionEvent)

تم إيقاف هذه السياسة نهائيًا، لذا يُرجى استخدام سياسة GetKeyEvent بدلاً منها. استرداد حدث إحالة ناجحة واحد

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

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

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

rpc GetCustomDimension(GetCustomDimensionRequest) returns (CustomDimension)

بحث عن CustomDimension واحد

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

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

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

rpc GetCustomMetric(GetCustomMetricRequest) returns (CustomMetric)

البحث عن CustomMetric واحد

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

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

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

rpc GetDataRetentionSettings(GetDataRetentionSettingsRequest) returns (DataRetentionSettings)

تعرِض هذه الطريقة إعدادات الاحتفاظ بالبيانات الفردية لهذا الموقع.

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

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

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

rpc GetDataSharingSettings(GetDataSharingSettingsRequest) returns (DataSharingSettings)

الحصول على إعدادات مشاركة البيانات في حساب إعدادات مشاركة البيانات هي عناصر فردية.

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

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

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

rpc GetDataStream(GetDataStreamRequest) returns (DataStream)

البحث عن مصدر بيانات واحد

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

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

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

rpc GetKeyEvent(GetKeyEventRequest) returns (KeyEvent)

استرداد حدث رئيسي واحد

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

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

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

rpc GetMeasurementProtocolSecret(GetMeasurementProtocolSecretRequest) returns (MeasurementProtocolSecret)

بحث عن MeasurementProtocolSecret واحد

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

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

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

rpc GetProperty(GetPropertyRequest) returns (Property)

البحث عن موقع واحد على "إحصاءات Google"

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

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

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

rpc ListAccountSummaries(ListAccountSummariesRequest) returns (ListAccountSummariesResponse)

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

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

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

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

rpc ListAccounts(ListAccountsRequest) returns (ListAccountsResponse)

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

يُرجى العِلم أنّ هذه الحسابات قد لا تتضمّن حاليًا مواقع على "إحصاءات Google". يتم تلقائيًا استبعاد الحسابات المحذوفة بشكل أوّلي (أي "نقلها إلى المهملات"). تعرِض هذه الطريقة قائمة فارغة في حال عدم العثور على أي حسابات ذات صلة.

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

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

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

rpc ListConversionEvents(ListConversionEventsRequest) returns (ListConversionEventsResponse)

تم إيقاف هذه السياسة نهائيًا، لذا يُرجى استخدام سياسة ListKeyEvents بدلاً منها. تعرِض هذه الطريقة قائمة بأحداث الإحالات الناجحة في الموقع الرئيسي المحدّد.

تعرِض هذه الطريقة قائمة فارغة في حال عدم العثور على أي أحداث إحالات ناجحة.

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

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

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

rpc ListCustomDimensions(ListCustomDimensionsRequest) returns (ListCustomDimensionsResponse)

تعرض هذه الطريقة قائمة بالسمات المخصّصة في أحد المواقع.

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

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

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

rpc ListCustomMetrics(ListCustomMetricsRequest) returns (ListCustomMetricsResponse)

تعرض هذه الطريقة قائمة بالمقاييس المخصّصة في أحد المواقع.

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

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

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

rpc ListDataStreams(ListDataStreamsRequest) returns (ListDataStreamsResponse)

تسرد هذه الطريقة مصادر البيانات في موقع.

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

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

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

rpc ListKeyEvents(ListKeyEventsRequest) returns (ListKeyEventsResponse)

تعرِض هذه الطريقة قائمة بالأحداث الرئيسية في الموقع الرئيسي المحدّد. تعرِض هذه الدالة قائمة فارغة في حال عدم العثور على أي أحداث رئيسية.

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

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

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

rpc ListMeasurementProtocolSecrets(ListMeasurementProtocolSecretsRequest) returns (ListMeasurementProtocolSecretsResponse)

تعرض هذه الطريقة أسرار Measurement Protocol الفرعية ضمن الموقع الرئيسي المحدّد.

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

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

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

rpc ListProperties(ListPropertiesRequest) returns (ListPropertiesResponse)

تعرِض هذه الطريقة المواقع الفرعية ضمن الحساب الرئيسي المحدّد.

سيتم استبعاد المواقع إذا لم يكن لدى المتصل إذن الوصول إليها. يتم تلقائيًا استبعاد المواقع المحذوفة مبدئيًا (أي "نقلها إلى المهملات"). تعرض هذه الطريقة قائمة فارغة إذا لم يتم العثور على أي خصائص ذات صلة.

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

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

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

rpc ProvisionAccountTicket(ProvisionAccountTicketRequest) returns (ProvisionAccountTicketResponse)

يطلب تذكرة لإنشاء حساب.

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

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

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

rpc RunAccessReport(RunAccessReportRequest) returns (RunAccessReportResponse)

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

يمكن طلب تقارير "الوصول إلى البيانات" لموقع معيّن. يمكن طلب التقارير لأي موقع، ولكن لا يمكن طلب السمات غير المرتبطة بالحصة إلا في مواقع "إحصاءات Google‏ 360". لا تتوفّر هذه الطريقة إلا للمشرفين.

تشمل سجلّات الوصول إلى البيانات هذه تقارير واجهة مستخدم "إحصاءات Google"، واستكشافات واجهة مستخدم "إحصاءات Google"، وGoogle Analytics Data API، ومنتجات أخرى مثل Firebase وAdMob التي يمكنها استرداد البيانات من "إحصاءات Google" من خلال الربط. لا تتضمّن هذه السجلاتّ تغييرات في إعدادات الموقع، مثل إضافة مصدر بيانات أو تغيير المنطقة الزمنية للموقع. للاطّلاع على سجلّ تغييرات الإعدادات، يُرجى الرجوع إلى searchChangeHistoryEvents.

لتقديم ملاحظاتك وآرائك عن واجهة برمجة التطبيقات هذه، يُرجى ملء نموذج ملاحظات وآراء عن تقارير الوصول في "إحصاءات Google".

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

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

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

rpc SearchChangeHistoryEvents(SearchChangeHistoryEventsRequest) returns (SearchChangeHistoryEventsResponse)

عمليات البحث في جميع التغييرات التي أُجريت على حساب أو حسابات الأطفال المرتبطة به، وذلك باستخدام مجموعة الفلاتر المحدّدة

لا تعرض هذه الطريقة سوى مجموعة فرعية من التغييرات التي تتيحها واجهة برمجة التطبيقات. قد تعرض واجهة المستخدم تغييرات إضافية.

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

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

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

rpc UpdateAccount(UpdateAccountRequest) returns (Account)

تعديل حساب

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

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

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

rpc UpdateConversionEvent(UpdateConversionEventRequest) returns (ConversionEvent)

تم إيقاف هذه السياسة نهائيًا، لذا يُرجى استخدام سياسة UpdateKeyEvent بدلاً منها. تعدِّل هذه الطريقة حدث إحالة ناجحة بالسمات المحدّدة.

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

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

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

rpc UpdateCustomDimension(UpdateCustomDimensionRequest) returns (CustomDimension)

تعديل CustomDimension في موقع أو تطبيق

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

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

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

rpc UpdateCustomMetric(UpdateCustomMetricRequest) returns (CustomMetric)

تعدّل هذه الطريقة مقياسًا مخصّصًا في موقع أو تطبيق.

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

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

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

rpc UpdateDataRetentionSettings(UpdateDataRetentionSettingsRequest) returns (DataRetentionSettings)

تعدِّل هذه الطريقة إعدادات الاحتفاظ بالبيانات الفردية لهذا الموقع.

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

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

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

rpc UpdateDataStream(UpdateDataStreamRequest) returns (DataStream)

تعدّل هذه الطريقة مصدر بيانات في موقع.

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

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

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

rpc UpdateKeyEvent(UpdateKeyEventRequest) returns (KeyEvent)

تعدِّل هذه الطريقة حدثًا رئيسيًا.

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

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

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

rpc UpdateMeasurementProtocolSecret(UpdateMeasurementProtocolSecretRequest) returns (MeasurementProtocolSecret)

تعدّل هذه الطريقة مفتاحًا سرّيًا لمنصّة Measurement Protocol.

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

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

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

rpc UpdateProperty(UpdatePropertyRequest) returns (Property)

تعديل موقع

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

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

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

AccessBetweenFilter

للتعبير عن أنّ النتيجة يجب أن تكون بين رقمَين (بما في ذلك الرقمَين).

الحقول
from_value

NumericValue

يبدأ بهذا الرقم.
to_value

NumericValue

ينتهي بهذا الرقم.

AccessDateRange

نطاق متجاور من الأيام: startDate وstartDate + 1 و... وendDate

الحقول
start_date

string

تمثّل هذه السمة تاريخ البدء الشامل لطلب البحث بالتنسيق YYYY-MM-DD. لا يمكن أن يقع التاريخ بعد endDate. يتم قبول التنسيق NdaysAgo أو yesterday أو today أيضًا، وفي هذه الحالة، يتم استنتاج التاريخ استنادًا إلى الوقت الحالي في المنطقة الزمنية للطلب.
end_date

string

تاريخ الانتهاء الشامل للاستعلام بالتنسيق YYYY-MM-DD لا يمكن أن يكون قبل startDate. يتم قبول التنسيق NdaysAgo أو yesterday أو today أيضًا، وفي هذه الحالة، يتم استنتاج التاريخ استنادًا إلى الوقت الحالي في المنطقة الزمنية للطلب.

AccessDimension

تمثِّل هذه السمات بياناتك. على سبيل المثال، تشير السمة userEmail إلى البريد الإلكتروني للمستخدم الذي وصل إلى بيانات التقارير. قيم السمات في ردود التقارير هي سلاسل.

الحقول
dimension_name

string

اسم السمة في واجهة برمجة التطبيقات اطّلِع على مخطط الوصول إلى البيانات للحصول على قائمة بالسمات المتوافقة مع واجهة برمجة التطبيقات هذه.

يتمّ الرجوع إلى السمات بالاسم في dimensionFilter وorderBys.

AccessDimensionHeader

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

الحقول
dimension_name

string

اسم السمة، مثل userEmail.

AccessDimensionValue

تمثّل هذه السمة قيمة إحدى السمات.

الحقول
value

string

قيمة السمة على سبيل المثال، قد تكون هذه القيمة هي "فرنسا" لسمة "البلد".

AccessFilter

تعبير لفلترة قيم السمات أو المقاييس

الحقول
field_name

string

اسم السمة أو اسم المقياس
حقل الربط one_filter حدِّد نوعًا واحدًا من الفلاتر لـ Filter. يمكن أن يكون التعليق one_filter إحدى القيم التالية فقط:
string_filter

AccessStringFilter

فلتر السلاسل ذات الصلة
in_list_filter

AccessInListFilter

فلتر للقيم في القائمة
numeric_filter

AccessNumericFilter

فلتر للقيم الرقمية أو قيم التاريخ
between_filter

AccessBetweenFilter

فلتر لقيمتَين

AccessFilterExpression

تعرض فلاتر السمات أو المقاييس. يجب أن تكون الحقول في التعبير نفسه إما جميعها سمات أو جميعها مقاييس.

الحقول
حقل الربط one_expression حدِّد نوعًا واحدًا من تعبيرات الفلتر لـ FilterExpression. يمكن أن يكون التعليق one_expression إحدى القيم التالية فقط:
and_group

AccessFilterExpressionList

ترتبط كلّ من FilterExpressions في and_group بعلاقة AND.
or_group

AccessFilterExpressionList

لكل FilterExpression في or_group علاقة OR.
not_expression

AccessFilterExpression

لا يكون FilterExpression من نوع not_expression.
access_filter

AccessFilter

فلتر أساسي في FilterExpression نفسه، يجب أن تكون جميع أسماء حقول الفلتر إما جميعها مكوّنات أو جميعها مقاييس.

AccessFilterExpressionList

قائمة بتعبيرات الفلتر

الحقول
expressions[]

AccessFilterExpression

قائمة بتعبيرات الفلتر

AccessInListFilter

يجب أن تكون النتيجة في قائمة من قيم السلسلة.

الحقول
values[]

string

قائمة قيم السلسلة يجب ألا يكون فارغًا.
case_sensitive

bool

إذا كانت القيمة true، تكون قيمة السلسلة حساسة لحالة الأحرف.

AccessMetric

القياسات الكمّية للتقرير على سبيل المثال، يمثّل المقياس accessCount إجمالي عدد سجلّات الوصول إلى البيانات.

الحقول
metric_name

string

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

يتم الرجوع إلى المقاييس بالاسم في metricFilter وorderBys.

AccessMetricHeader

تصف هذه السمة عمود مقياس في التقرير. تؤدي المقاييس المرئية المطلوبة في التقرير إلى إنشاء إدخالات أعمدة ضمن الصفوف وMetricHeaders. ومع ذلك، فإنّ المقاييس المستخدَمة حصريًا في الفلاتر أو التعبيرات لا تُنشئ أعمدة في التقرير، وبالتالي لا تُنشئ هذه المقاييس عناوين.

الحقول
metric_name

string

اسم المقياس، مثل accessCount.

AccessMetricValue

قيمة المقياس

الحقول
value

string

تمثّل هذه السمة قيمة القياس. على سبيل المثال، قد تكون هذه القيمة ‎ '13'.

AccessNumericFilter

فلاتر للقيم الرقمية أو قيم التاريخ

الحقول
operation

Operation

تمثّل هذه السمة نوع العملية لهذا الفلتر.
value

NumericValue

قيمة رقمية أو قيمة تاريخ

العملية

العملية التي تم تطبيقها على فلتر رقمي

عمليات التعداد
OPERATION_UNSPECIFIED غير محدد
EQUAL يساوي
LESS_THAN أقل من
LESS_THAN_OR_EQUAL أصغر من أو يساوي
GREATER_THAN أكبر من
GREATER_THAN_OR_EQUAL أكبر من أو يساوي

AccessOrderBy

تحدّد عبارات Order by كيفية ترتيب الصفوف في الردّ. على سبيل المثال، ترتيب الصفوف حسب عدد مرات الوصول تنازليًا هو ترتيب واحد، وترتيب الصفوف حسب سلسلة البلد هو ترتيب مختلف.

الحقول
desc

bool

إذا كانت القيمة صحيحة، يتم الترتيب تنازليًا. إذا كانت القيمة false أو لم يتم تحديدها، يتم الفرز بترتيب تصاعدي.
حقل الربط one_order_by حدِّد نوعًا واحدًا من ترتيب النتائج حسب OrderBy. يمكن أن يكون التعليق one_order_by إحدى القيم التالية فقط:
metric

MetricOrderBy

ترتّب النتائج حسب قيم أحد المقاييس.
dimension

DimensionOrderBy

ترتّب النتائج حسب قيم إحدى السمات.

DimensionOrderBy

يتم الترتيب حسب قيم السمة.

الحقول
dimension_name

string

اسم سمة في الطلب يتم الترتيب حسبها.
order_type

OrderType

تتحكّم هذه السمة في قاعدة ترتيب قيم السمات.

OrderType

قاعدة لترتيب قيم سمة السلسلة حسبها

عمليات التعداد
ORDER_TYPE_UNSPECIFIED غير محدد
ALPHANUMERIC الترتيب أبجديًا رقميًا حسب قيمة موضع رمز Unicode على سبيل المثال، "2" < "A" < "X" < "b" < "z".
CASE_INSENSITIVE_ALPHANUMERIC ترتيب أبجدي رقمي غير حسّاس لحالة الأحرف حسب قيمة موضع رمز يونيكود للأحرف الصغيرة على سبيل المثال، "2" < "A" < "b" < "X" < "z".
NUMERIC يتم تحويل قيم السمات إلى أرقام قبل ترتيبها. على سبيل المثال، في الترتيب NUMERIC، تكون القيمة "25" أصغر من "100"، وفي الترتيب ALPHANUMERIC، تكون القيمة "100" أصغر من "25". تكون جميع قيم السمات غير الرقمية ذات قيمة ترتيب متساوية أقل من جميع القيم الرقمية.

MetricOrderBy

يتم الترتيب حسب قيم المقاييس.

الحقول
metric_name

string

اسم مقياس في الطلب للترتيب حسبه.

AccessQuota

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

الحقول
tokens_per_day

AccessQuotaStatus

يمكن للمواقع الإلكترونية استخدام 250,000 رمز مميّز في اليوم. تستهلك معظم الطلبات أقل من 10 رموز مميّزة.
tokens_per_hour

AccessQuotaStatus

يمكن للمواقع استخدام 50,000 رمز مميّز في الساعة. يستهلك طلب بيانات من واجهة برمجة التطبيقات عددًا واحدًا من الرموز المميزة، ويتم خصم هذا العدد من جميع الحصص المتاحة كل ساعة وكل يوم ولكل مشروع كل ساعة.
concurrent_requests

AccessQuotaStatus

يمكن أن تستخدم المواقع ما يصل إلى 50 طلبًا متزامنًا.
server_errors_per_project_per_hour

AccessQuotaStatus

يمكن أن يحدث ما يصل إلى 50 خطأ في الخادم في الساعة لكل زوج من المواقع الإلكترونية والمشاريع على السحابة الإلكترونية.
tokens_per_project_per_hour

AccessQuotaStatus

يمكن أن تستخدم المواقع ما يصل إلى% 25 من الرموز المميزة لكل مشروع في الساعة. يبلغ عدد الرموز المميّزة التي يمكن أن تستخدمها مواقع "إحصاءات Google‏ 360" ‏12,500 رمز مميّز لكل مشروع في الساعة. يستهلك طلب بيانات من واجهة برمجة التطبيقات عددًا واحدًا من الرموز المميزة، ويتم خصم هذا العدد من جميع الحصص المتاحة كل ساعة وكل يوم ولكل مشروع كل ساعة.

AccessQuotaStatus

الحالة الحالية لمجموعة حصص معيّنة

الحقول
consumed

int32

الحصة المستخدَمة في هذا الطلب.
remaining

int32

الحصة المتبقية بعد هذا الطلب

AccessRow

الوصول إلى بيانات التقرير لكل صف

الحقول
dimension_values[]

AccessDimensionValue

قائمة بقيم السمات تكون هذه القيم بالترتيب نفسه المحدّد في الطلب.
metric_values[]

AccessMetricValue

قائمة بقيم المقاييس تكون هذه القيم بالترتيب نفسه المحدّد في الطلب.

AccessStringFilter

فلتر السلاسل

الحقول
match_type

MatchType

نوع المطابقة لهذا الفلتر.
value

string

قيمة السلسلة المستخدَمة للمطابقة
case_sensitive

bool

إذا كانت القيمة true، تكون قيمة السلسلة حساسة لحالة الأحرف.

MatchType

نوع مطابقة فلتر السلسلة

عمليات التعداد
MATCH_TYPE_UNSPECIFIED غير محدّد
EXACT مطابقة تامة لقيمة السلسلة
BEGINS_WITH تبدأ بقيمة السلسلة.
ENDS_WITH تنتهي بالقيمة السلسلة.
CONTAINS يحتوي على قيمة السلسلة.
FULL_REGEXP مطابقة كاملة للتعبير العادي مع قيمة السلسلة
PARTIAL_REGEXP مطابقة جزئية للتعبير العادي مع قيمة السلسلة

Account

رسالة مورد تمثّل حسابًا على "إحصاءات Google".

الحقول
name

string

المعرّف. اسم المورد لهذا الحساب. التنسيق: accounts/{account} مثال: "accounts/100"
create_time

Timestamp

النتائج فقط. الوقت الذي تم فيه إنشاء هذا الحساب في الأصل
update_time

Timestamp

النتائج فقط. الوقت الذي تم فيه آخر تعديل لحقول حمولة الحساب
display_name

string

الحقل مطلوب. الاسم المعروض لهذا الحساب والذي يمكن للمستخدمين قراءته
region_code

string

بلد النشاط التجاري يجب أن يكون رمز منطقة Unicode CLDR.
deleted

bool

النتائج فقط. توضّح هذه السمة ما إذا كان قد تم حذف هذا الحساب بشكل مبدئي أم لا. يتم استبعاد الحسابات المحذوفة من نتائج "القائمة" ما لم يُطلب ذلك تحديدًا.
gmp_organization

string

النتائج فقط. معرّف الموارد المنتظم لمورد مؤسسة على "منصة Google للتسويق". يتم ضبط هذا الحقل فقط عندما يكون هذا الحساب مرتبطًا بمؤسسة على "منصة Google للتسويق". التنسيق: marketingplatformadmin.googleapis.com/organizations/{org_id}

AccountSummary

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

الحقول
name

string

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

string

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

string

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

PropertySummary

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

AcknowledgeUserDataCollectionRequest

رسالة الطلب لـ AcknowledgeUserDataCollection RPC

الحقول
property

string

الحقل مطلوب. الموقع الذي يجب الإقرار بجمع بيانات المستخدمين فيه.
acknowledgement

string

الحقل مطلوب. إقرار بأنّ الجهة التي تستدعي هذه الطريقة تفهم بنود جمع بيانات المستخدمين.

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

AcknowledgeUserDataCollectionResponse

لا يتضمّن هذا النوع أي حقول.

رسالة الرد على إجراء AcknowledgeUserDataCollection RPC.

ActionType

أنواع الإجراءات التي قد تغيّر أحد الموارد

عمليات التعداد
ACTION_TYPE_UNSPECIFIED نوع الإجراء غير معروف أو غير محدّد.
CREATED تم إنشاء المرجع في هذا التغيير.
UPDATED تم تعديل المورد في هذا التغيير.
DELETED تم حذف المرجع في هذا التغيير.

ActorType

أنواع مختلفة من الجهات التي يمكنها إجراء تغييرات على موارد "إحصاءات Google"

عمليات التعداد
ACTOR_TYPE_UNSPECIFIED نوع الجهة الفاعلة غير معروف أو غير محدّد.
USER التغييرات التي أجراها المستخدم المحدّد في actor_email
SYSTEM التغييرات التي أجراها نظام "إحصاءات Google"
SUPPORT التغييرات التي يجريها موظفو فريق دعم "إحصاءات Google"

ArchiveCustomDimensionRequest

طلب رسالة لـ ArchiveCustomDimension RPC.

الحقول
name

string

الحقل مطلوب. تمثّل هذه السمة اسم CustomDimension المطلوب أرشفته. مثال على التنسيق: properties/1234/customDimensions/5678

ArchiveCustomMetricRequest

رسالة الطلب الخاصة باستدعاء إجراء ArchiveCustomMetric عن بُعد.

الحقول
name

string

الحقل مطلوب. اسم CustomMetric المطلوب أرشفته. مثال على التنسيق: properties/1234/customMetrics/5678

ChangeHistoryChange

وصف لتغيير في أحد موارد "إحصاءات Google".

الحقول
resource

string

اسم المورد الذي يصف هذا الإدخال التغييرات التي تم إجراؤها عليه.
action

ActionType

نوع الإجراء الذي غيّر هذا المورد.
resource_before_change

ChangeHistoryResource

محتوى المرجع قبل إجراء التغيير إذا تم إنشاء هذا المرجع في هذا التغيير، لن يظهر هذا الحقل.
resource_after_change

ChangeHistoryResource

محتوى المورد بعد إجراء التغيير إذا تم حذف هذا المرجع في هذا التغيير، لن يظهر هذا الحقل.

ChangeHistoryResource

لقطة لمورد كما كان قبل أو بعد نتيجة تغيير في سجلّ التغييرات

الحقول

حقل الربط resource

يمكن أن يكون التعليق resource إحدى القيم التالية فقط:
account

Account

لقطة لمورد "حساب" في سجلّ التغييرات
property

Property

لقطة لمورد "الموقع" في سجلّ التغييرات
conversion_event

ConversionEvent

لقطة لمورد ConversionEvent في سجلّ التغييرات
measurement_protocol_secret

MeasurementProtocolSecret

لقطة من مرجع MeasurementProtocolSecret في سجلّ التغييرات
data_retention_settings

DataRetentionSettings

لقطة لمورد إعدادات الاحتفاظ بالبيانات في سجلّ التغييرات
data_stream

DataStream

لقطة لمصدر DataStream في سجلّ التغييرات

ChangeHistoryEvent

مجموعة من التغييرات في حساب "إحصاءات Google" أو المواقع التابعة له، والتي نتجت عن السبب نفسه. تشمل الأسباب الشائعة التعديلات التي تم إجراؤها في واجهة مستخدم "إحصاءات Google"، أو التغييرات التي أجراها فريق دعم العملاء، أو التغييرات التلقائية التي أجراها نظام "إحصاءات Google".

الحقول
id

string

رقم تعريف حدث سجلّ التغيير هذا. هذا المعرّف فريد على مستوى "إحصاءات Google".
change_time

Timestamp

وقت إجراء التغيير
actor_type

ActorType

نوع الجهة الفاعلة التي أجرت هذا التغيير
user_actor_email

string

عنوان البريد الإلكتروني لحساب Google الذي أجرى التغيير سيكون هذا العنوان صالحًا إذا تم ضبط حقل "المُنفِّذ" على USER، وسيكون فارغًا في الحالات الأخرى. ستؤدي حسابات Google التي تم حذفها إلى حدوث خطأ.
changes_filtered

bool

إذا كانت القيمة true، يعني ذلك أنّه تم فلترة قائمة التغييرات التي تم عرضها، وأنّها لا تمثّل جميع التغييرات التي حدثت في هذا الحدث.
changes[]

ChangeHistoryChange

قائمة بالتغييرات التي تم إجراؤها في حدث سجلّ التغييرات هذا والتي تتطابق مع الفلاتر المحدّدة في SearchChangeHistoryEventsRequest.

ChangeHistoryResourceType

أنواع الموارد التي يمكن أن يتم عرض تغييراتها من سجلّ التغييرات.

عمليات التعداد
CHANGE_HISTORY_RESOURCE_TYPE_UNSPECIFIED نوع المورد غير معروف أو غير محدّد.
ACCOUNT مورد الحساب
PROPERTY مورد الموقع
GOOGLE_SIGNALS_SETTINGS مورد GoogleSignalsSettings
CONVERSION_EVENT مورد ConversionEvent
MEASUREMENT_PROTOCOL_SECRET مورد MeasurementProtocolSecret
CUSTOM_DIMENSION مورد CustomDimension
CUSTOM_METRIC مورد CustomMetric
DATA_RETENTION_SETTINGS مورد DataRetentionSettings
DATA_STREAM مورد DataStream
ATTRIBUTION_SETTINGS مورد AttributionSettings

ConversionEvent

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

الحقول
name

string

المعرّف. اسم المورد لحدث الإحالة الناجحة هذا. التنسيق: properties/{property}/conversionEvents/{conversion_event}
event_name

string

غير قابل للتغيير اسم حدث الإحالة الناجحة هذا أمثلة: "click" و"purchase"
create_time

Timestamp

النتائج فقط. الوقت الذي تم فيه إنشاء حدث الإحالة الناجحة هذا في الموقع.
deletable

bool

النتائج فقط. في حال ضبط هذا الحدث، يمكن حذفه حاليًا باستخدام DeleteConversionEvent.
custom

bool

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

ConversionCountingMethod

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

DefaultConversionValue

اختياريّ. تحدّد هذه السمة القيمة التلقائية أو العملة التلقائية لحدث إحالة ناجحة.

ConversionCountingMethod

الطريقة التي سيتمّ بها احتساب الإحالات الناجحة على مستوى أحداث متعدّدة ضِمن جلسة واحدة

عمليات التعداد
CONVERSION_COUNTING_METHOD_UNSPECIFIED لم يتم تحديد طريقة الاحتساب.
ONCE_PER_EVENT يُعدّ كل مثيل حدث إحالة ناجحة.
ONCE_PER_SESSION يُعدّ مثيل الحدث إحالة ناجحة مرة واحدة على الأكثر لكل جلسة لكل مستخدم.

DefaultConversionValue

تحدّد هذه السمة القيمة التلقائية أو العملة التلقائية لحدث إحالة ناجحة. يجب تقديم كلّ من القيمة والعملة.

الحقول
value

double

سيتم استخدام هذه القيمة لتعبئة قيمة جميع الإحالات الناجحة لاسم الحدث المحدّد حيث لم يتم ضبط مَعلمة "القيمة" للحدث.
currency_code

string

عندما لا يتضمّن حدث إحالة ناجحة لـ event_name عملة محدّدة، سيتم تطبيق هذه العملة كعملة تلقائية. يجب أن يكون بالتنسيق ISO 4217 لرمز العملة. لمزيد من المعلومات، يُرجى الانتقال إلى https://en.wikipedia.org/wiki/ISO_4217.

CreateConversionEventRequest

طلب الرسالة لـ CreateConversionEvent RPC

الحقول
conversion_event

ConversionEvent

الحقل مطلوب. حدث الإحالة الناجحة المطلوب إنشاؤه.
parent

string

الحقل مطلوب. اسم المورد للموقع الأصل الذي سيتم إنشاء حدث الإحالة الناجحة هذا فيه. التنسيق: properties/123

CreateCustomDimensionRequest

رسالة الطلب لإجراء CreateCustomDimension عن بُعد.

الحقول
parent

string

الحقل مطلوب. مثال على التنسيق: properties/1234
custom_dimension

CustomDimension

الحقل مطلوب. السمة المخصّصة التي سيتم إنشاؤها.

CreateCustomMetricRequest

طلب رسالة لـ CreateCustomMetric RPC.

الحقول
parent

string

الحقل مطلوب. مثال على التنسيق: properties/1234
custom_metric

CustomMetric

الحقل مطلوب. تمثّل هذه السمة المقياس المخصّص المطلوب إنشاؤه.

CreateDataStreamRequest

رسالة الطلب لإجراء CreateDataStream RPC.

الحقول
parent

string

الحقل مطلوب. مثال على التنسيق: properties/1234
data_stream

DataStream

الحقل مطلوب. تمثّل هذه السمة مصدر البيانات المطلوب إنشاؤه.

CreateFirebaseLinkRequest

طلب الرسالة لاستدعاء إجراء CreateFirebaseLink عن بُعد

الحقول
parent

string

الحقل مطلوب. التنسيق: properties/{property_id}

مثلاً: properties/1234

CreateGoogleAdsLinkRequest

رسالة الطلب لإجراء CreateGoogleAdsLink عن بُعد

الحقول
parent

string

الحقل مطلوب. مثال على التنسيق: properties/1234

CreateKeyEventRequest

طلب رسالة لإجراء CreateKeyEvent RPC

الحقول
key_event

KeyEvent

الحقل مطلوب. الحدث الرئيسي المطلوب إنشاؤه.
parent

string

الحقل مطلوب. اسم المورد للموقع الرئيسي الذي سيتم إنشاء هذا الحدث الرئيسي فيه. التنسيق: properties/123

CreateMeasurementProtocolSecretRequest

طلب رسالة لإجراء CreateMeasurementProtocolSecret RPC

الحقول
parent

string

الحقل مطلوب. المورد الرئيسي الذي سيتم إنشاء هذا السرّ فيه. التنسيق: properties/{property}/dataStreams/{dataStream}
measurement_protocol_secret

MeasurementProtocolSecret

الحقل مطلوب. الرمز السري لبروتوكول القياس المطلوب إنشاؤه.

CreatePropertyRequest

رسالة الطلب لإجراء CreateProperty عن بُعد (RPC).

الحقول
property

Property

الحقل مطلوب. الموقع المطلوب إنشاؤه ملاحظة: يجب أن يحدّد الموقع المقدَّم الموقع الرئيسي.

CustomDimension

تعريف لـ CustomDimension.

الحقول
name

string

المعرّف. اسم المورد الخاص بمورد CustomDimension هذا. التنسيق: properties/{property}/customDimensions/{customDimension}
parameter_name

string

الحقل مطلوب. غير قابل للتغيير اسم مَعلمة وضع العلامات لهذه السمة المخصّصة.

إذا كانت هذه سمة على مستوى المستخدِم، سيكون هذا هو اسم خاصيّة المستخدِم. إذا كانت هذه سمة على مستوى الحدث، سيكون هذا هو اسم مَعلمة خاصة بالحدث.

إذا كانت هذه سمة على مستوى المنتج أو الخدمة، سيكون هذا هو اسم المَعلمة التي تم العثور عليها في مصفوفة سلع التجارة الإلكترونية.

يمكن أن يحتوي على أحرف أبجدية رقمية وشرطات سفلية فقط، بدءًا بحرف. يجب ألا يتجاوز طول السمات على مستوى المستخدِم 24 حرفًا، وطول السمات على مستوى الحدث 40 حرفًا.
display_name

string

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

string

اختياريّ. وصف لهذه السمة المخصّصة الحدّ الأقصى هو 150 حرفًا.
scope

DimensionScope

الحقل مطلوب. غير قابل للتغيير نطاق هذه السمة.
disallow_ads_personalization

bool

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

لا تتوفّر هذه الميزة حاليًا إلا للمكوّنات المخصّصة على مستوى المستخدم.

DimensionScope

القيم الصالحة لنطاق هذه السمة.

عمليات التعداد
DIMENSION_SCOPE_UNSPECIFIED النطاق غير معروف أو لم يتم تحديده.
EVENT سمة على مستوى الحدث
USER سمة على مستوى المستخدِم
ITEM سمة على مستوى منتجات التجارة الإلكترونية

CustomMetric

تعريف لمقياس مخصّص

الحقول
name

string

المعرّف. اسم المورد الخاص بمورد CustomMetric هذا. التنسيق: properties/{property}/customMetrics/{customMetric}
parameter_name

string

الحقل مطلوب. غير قابل للتغيير اسم وضع العلامات لهذا المقياس المخصّص.

إذا كان هذا المقياس على مستوى الحدث، سيكون هذا هو اسم مَعلمة خاصة بالحدث.

يمكن أن يحتوي على أحرف أبجدية رقمية وشرطات سفلية فقط، بدءًا بحرف. يجب ألا يتجاوز طول المقاييس على مستوى الحدث 40 حرفًا.
display_name

string

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

string

اختياريّ. وصف لهذه السمة المخصّصة الحدّ الأقصى هو 150 حرفًا.
measurement_unit

MeasurementUnit

الحقل مطلوب. تمثّل هذه السمة نوع قيمة المقياس المخصّص.
scope

MetricScope

الحقل مطلوب. غير قابل للتغيير نطاق هذا المقياس المخصّص.
restricted_metric_type[]

RestrictedMetricType

اختياريّ. أنواع البيانات المحظورة التي قد يتضمّنها هذا المقياس مطلوبة للمقاييس التي تستخدم وحدة قياس CURRENCY. يجب أن يكون هذا الحقل فارغًا للمقاييس التي تستخدم وحدة قياس غير CURRENCY.

MeasurementUnit

الأنواع المحتملة لتمثيل قيمة المقياس المخصّص.

قد يتغيّر تمثيل العملة في المستقبل، ما يستلزم إجراء تغيير غير متوافق في واجهة برمجة التطبيقات.

عمليات التعداد
MEASUREMENT_UNIT_UNSPECIFIED لم يتم تحديد MeasurementUnit أو أنّه غير متوفّر.
STANDARD يستخدم هذا المقياس الوحدات التلقائية.
CURRENCY يقيس هذا المقياس عملة.
FEET يقيس هذا المقياس القدم.
METERS يقيس هذا المقياس الأمتار.
KILOMETERS يقيس هذا المقياس المسافة بالكيلومترات.
MILES يقيس هذا المقياس المسافة بالأميال.
MILLISECONDS يقيس هذا المقياس بالملّي ثانية.
SECONDS يقيس هذا المقياس الوقت بالثواني.
MINUTES يقيس هذا المقياس عدد الدقائق.
HOURS يقيس هذا المقياس الساعات.

MetricScope

نطاق هذا المقياس.

عمليات التعداد
METRIC_SCOPE_UNSPECIFIED النطاق غير معروف أو لم يتم تحديده.
EVENT مقياس على مستوى الحدث

RestrictedMetricType

تصنيفات تحدّد البيانات في هذا المقياس المخصّص على أنّها بيانات يجب حصرها على مستخدمين محدّدين.

عمليات التعداد
RESTRICTED_METRIC_TYPE_UNSPECIFIED النوع غير معروف أو غير محدّد.
COST_DATA تعرض المقاييس بيانات التكلفة.
REVENUE_DATA تعرض تقارير المقاييس بيانات الإيرادات.

DataRetentionSettings

قيم الإعدادات للاحتفاظ بالبيانات هذا مورد فردي.

الحقول
name

string

المعرّف. اسم المورد الخاص بمورد DataRetentionSetting هذا. التنسيق: properties/{property}/dataRetentionSettings
event_data_retention

RetentionDuration

الحقل مطلوب. مدة الاحتفاظ بالبيانات على مستوى الحدث
user_data_retention

RetentionDuration

الحقل مطلوب. مدة الاحتفاظ بالبيانات على مستوى المستخدم
reset_user_data_on_new_activity

bool

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

RetentionDuration

القيم الصالحة لمدة الاحتفاظ بالبيانات

عمليات التعداد
RETENTION_DURATION_UNSPECIFIED لم يتم تحديد مدة الاحتفاظ بالبيانات.
TWO_MONTHS مدة الاحتفاظ بالبيانات هي شهران.
FOURTEEN_MONTHS مدة الاحتفاظ بالبيانات هي 14 شهرًا.
TWENTY_SIX_MONTHS تبلغ مدة الاحتفاظ بالبيانات 26 شهرًا. متاحة لمواقع "إحصاءات Google‏ 360" فقط. تتوفّر لبيانات الأحداث فقط.
THIRTY_EIGHT_MONTHS مدة الاحتفاظ بالبيانات هي 38 شهرًا. متاحة لمواقع "إحصاءات Google‏ 360" فقط. تتوفّر لبيانات الأحداث فقط.
FIFTY_MONTHS مدة الاحتفاظ بالبيانات هي 50 شهرًا. متاحة لمواقع "إحصاءات Google‏ 360" فقط. تتوفّر لبيانات الأحداث فقط.

DataSharingSettings

رسالة مورد تمثّل إعدادات مشاركة البيانات في حساب على "إحصاءات Google".

الحقول
name

string

المعرّف. اسم المورد التنسيق: accounts/{account}/dataSharingSettings مثال: "accounts/1000/dataSharingSettings"
sharing_with_google_support_enabled

bool

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

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

bool

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

يرتبط هذا الحقل بحقل "اقتراحات لمؤسستك" في واجهة مستخدم "المدير" في "إحصاءات Google".
sharing_with_google_any_sales_enabled
(deprecated)

bool

تمّ الإيقاف. لم يعُد هذا الحقل مستخدَمًا ويعرض القيمة "خطأ" دائمًا.
sharing_with_google_products_enabled

bool

يسمح هذا الخيار لـ Google باستخدام البيانات لتحسين منتجات أو خدمات Google الأخرى.

يرتبط هذا الحقل بالحقل "منتجات Google وخدماتها" في واجهة مستخدم "المدير" في "إحصاءات Google".
sharing_with_others_enabled

bool

يمكنك تفعيل ميزات من شأنها أن توفّر لك إحصاءات أكثر تفصيلاً عن مؤسستك عندما تساهم في بيانات القياس المجمّعة، مثل ميزات التوقّعات والبيانات النموذجية وقياس الأداء. يتم تجميع البيانات التي تشاركها (بما في ذلك معلومات عن الموقع الذي تتم مشاركتها منه) وإخفاء معلومات تحديد الهوية فيها قبل استخدامها لإنشاء إحصاءات النشاط التجاري.

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

DataStream

رسالة مورد تمثّل مصدر بيانات

الحقول
name

string

المعرّف. اسم المورد لمصدر البيانات هذا. التنسيق: properties/{property_id}/dataStreams/{stream_id} مثال: "properties/1000/dataStreams/2000"
type

DataStreamType

الحقل مطلوب. غير قابل للتغيير نوع مصدر البيانات هذا.
display_name

string

تمثّل هذه السمة الاسم المعروض لمصدر البيانات والذي يمكن للمستخدمين قراءته.

مطلوب لمصادر بيانات المواقع الإلكترونية.

الحد الأقصى لطول الاسم المعروض المسموح به هو 255 وحدة رمز UTF-16.
create_time

Timestamp

النتائج فقط. الوقت الذي تم فيه إنشاء ساحة المشاركات هذه في الأصل
update_time

Timestamp

النتائج فقط. الوقت الذي تم فيه تعديل حقول حمولة البث آخر مرة
حقل الربط stream_data بيانات لأنواع معيّنة من مصادر البيانات تتطابق الرسالة التي سيتم ضبطها مع نوع ساحة المشاركات هذه. يمكن أن يكون التعليق stream_data إحدى القيم التالية فقط:
web_stream_data

WebStreamData

البيانات الخاصة بمصادر بيانات المواقع الإلكترونية يجب ملء هذا الحقل إذا كان النوع هو WEB_DATA_STREAM.
android_app_stream_data

AndroidAppStreamData

بيانات خاصة بمصادر بيانات تطبيقات Android يجب ملء هذا الحقل إذا كان النوع هو ANDROID_APP_DATA_STREAM.
ios_app_stream_data

IosAppStreamData

البيانات الخاصة بمصادر بيانات تطبيقات iOS يجب ملء هذا الحقل إذا كان النوع IOS_APP_DATA_STREAM.

AndroidAppStreamData

بيانات خاصة بمصادر بيانات تطبيقات Android

الحقول
firebase_app_id

string

النتائج فقط. معرّف تطبيق Android المقابل في Firebase، إن وُجد يمكن أن يتغيّر هذا المعرّف إذا تم حذف تطبيق Android وإعادة إنشائه.
package_name

string

غير قابل للتغيير اسم حزمة التطبيق الذي يتم قياسه مثال: "com.example.myandroidapp"

DataStreamType

نوع مصدر البيانات.

عمليات التعداد
DATA_STREAM_TYPE_UNSPECIFIED النوع غير معروف أو لم يتم تحديده.
WEB_DATA_STREAM مصدر بيانات الموقع الإلكتروني
ANDROID_APP_DATA_STREAM مصدر بيانات تطبيق Android
IOS_APP_DATA_STREAM مصدر بيانات تطبيق iOS

IosAppStreamData

البيانات الخاصة بمصادر بيانات تطبيقات iOS

الحقول
firebase_app_id

string

النتائج فقط. معرّف تطبيق iOS المقابل في Firebase، إن وُجد. يمكن أن يتغيّر هذا المعرّف إذا تم حذف تطبيق iOS وإعادة إنشائه.
bundle_id

string

الحقل مطلوب. غير قابل للتغيير معرّف حزمة Apple App Store للتطبيق، مثال: "com.example.myiosapp"

WebStreamData

البيانات الخاصة بمصادر بيانات المواقع الإلكترونية

الحقول
measurement_id

string

النتائج فقط. رقم تعريف القياس في "إحصاءات Google"

مثال: "G-1A2BCD345E"
firebase_app_id

string

النتائج فقط. معرّف تطبيق الويب المقابل في Firebase، إن وُجد يمكن أن يتغيّر هذا المعرّف إذا تم حذف تطبيق الويب وإعادة إنشائه.
default_uri

string

اسم نطاق تطبيق الويب الذي يتم قياسه، أو فارغ. مثال: "http://www.google.com" أو "https://www.google.com"

DeleteAccountRequest

رسالة الطلب الخاصة بإجراء DeleteAccount RPC.

الحقول
name

string

الحقل مطلوب. اسم الحساب المطلوب حذفه مؤقتًا. التنسيق: accounts/{account} مثال: "accounts/100"

DeleteConversionEventRequest

رسالة الطلب الخاصة بـ DeleteConversionEvent RPC

الحقول
name

string

الحقل مطلوب. اسم المورد لحدث الإحالة الناجحة المطلوب حذفه. التنسيق: properties/{property}/conversionEvents/{conversion_event} مثال: "properties/123/conversionEvents/456"

DeleteDataStreamRequest

رسالة الطلب الخاصة باستدعاء إجراء DeleteDataStream عن بُعد

الحقول
name

string

الحقل مطلوب. تمثّل هذه السمة اسم DataStream المطلوب حذفه. مثال على التنسيق: properties/1234/dataStreams/5678

DeleteFirebaseLinkRequest

رسالة الطلب الخاصة بـ DeleteFirebaseLink RPC

الحقول
name

string

الحقل مطلوب. التنسيق: properties/{property_id}/firebaseLinks/{firebase_link_id}

مثلاً: properties/1234/firebaseLinks/5678

DeleteGoogleAdsLinkRequest

رسالة الطلب الخاصة بإجراء DeleteGoogleAdsLink RPC.

الحقول
name

string

الحقل مطلوب. تنسيق المثال: properties/1234/googleAdsLinks/5678

DeleteKeyEventRequest

رسالة الطلب الخاصة بإجراء DeleteKeyEvent RPC

الحقول
name

string

الحقل مطلوب. اسم المورد للحدث الرئيسي المطلوب حذفه. التنسيق: properties/{property}/keyEvents/{key_event} مثال: "properties/123/keyEvents/456"

DeleteMeasurementProtocolSecretRequest

رسالة الطلب الخاصة باستدعاء إجراء DeleteMeasurementProtocolSecret RPC

الحقول
name

string

الحقل مطلوب. اسم MeasurementProtocolSecret المطلوب حذفه. التنسيق: properties/{property}/dataStreams/{dataStream}/measurementProtocolSecrets/{measurementProtocolSecret}

DeletePropertyRequest

رسالة الطلب الخاصة بـ DeleteProperty RPC

الحقول
name

string

الحقل مطلوب. اسم الموقع المطلوب حذفه مؤقتًا التنسيق: properties/{property_id} مثال: "properties/1000"

GetAccountRequest

رسالة الطلب الخاصة باستدعاء إجراء GetAccount عن بُعد

الحقول
name

string

الحقل مطلوب. تمثّل هذه السمة اسم الحساب المطلوب البحث عنه. التنسيق: accounts/{account} مثال: "accounts/100"

GetConversionEventRequest

رسالة الطلب الخاصة بـ GetConversionEvent RPC

الحقول
name

string

الحقل مطلوب. اسم المورد لحدث الإحالة الناجحة المطلوب استرداده. التنسيق: properties/{property}/conversionEvents/{conversion_event} مثال: "properties/123/conversionEvents/456"

GetCustomDimensionRequest

طلب رسالة لمتوسط عائد النقرة GetCustomDimension.

الحقول
name

string

الحقل مطلوب. اسم CustomDimension المطلوب الحصول عليه. مثال على التنسيق: properties/1234/customDimensions/5678

GetCustomMetricRequest

رسالة الطلب لـ GetCustomMetric RPC.

الحقول
name

string

الحقل مطلوب. اسم CustomMetric المطلوب الحصول عليه. مثال على التنسيق: properties/1234/customMetrics/5678

GetDataRetentionSettingsRequest

رسالة الطلب لاستدعاء إجراء GetDataRetentionSettings عن بُعد (RPC)

الحقول
name

string

الحقل مطلوب. اسم الإعدادات المطلوب البحث عنها التنسيق: properties/{property}/dataRetentionSettings مثال: "properties/1000/dataRetentionSettings"

GetDataSharingSettingsRequest

رسالة الطلب الخاصة باستدعاء إجراء GetDataSharingSettings عن بُعد (RPC)

الحقول
name

string

الحقل مطلوب. اسم الإعدادات المطلوب البحث عنها التنسيق: accounts/{account}/dataSharingSettings

مثلاً: accounts/1000/dataSharingSettings

GetDataStreamRequest

رسالة الطلب الخاصة باستدعاء إجراء GetDataStream عن بُعد (RPC).

الحقول
name

string

الحقل مطلوب. اسم DataStream المطلوب الحصول عليه مثال على التنسيق: properties/1234/dataStreams/5678

GetKeyEventRequest

طلب رسالة GetKeyEvent RPC

الحقول
name

string

الحقل مطلوب. اسم المورد الخاص بالحدث الرئيسي المطلوب استرداده. التنسيق: properties/{property}/keyEvents/{key_event} مثال: "properties/123/keyEvents/456"

GetMeasurementProtocolSecretRequest

رسالة الطلب الخاصة باستدعاء إجراء GetMeasurementProtocolSecret عن بُعد.

الحقول
name

string

الحقل مطلوب. اسم مفتاح Measurement Protocol السرّي الذي سيتم البحث عنه. التنسيق: properties/{property}/dataStreams/{dataStream}/measurementProtocolSecrets/{measurementProtocolSecret}

GetPropertyRequest

طلب رسالة لإجراء GetProperty عن بُعد

الحقول
name

string

الحقل مطلوب. اسم السمة المطلوب البحث عنها التنسيق: properties/{property_id} مثال: "properties/1000"

IndustryCategory

الفئة المحدّدة لهذا الموقع، والتي تُستخدَم للمقارنة بمقاييس الأداء العامة في المجال

عمليات التعداد
INDUSTRY_CATEGORY_UNSPECIFIED فئة المجال غير محدّدة
AUTOMOTIVE سيارات
BUSINESS_AND_INDUSTRIAL_MARKETS أسواق تجارية وصناعية
FINANCE شؤون مالية
HEALTHCARE الرعاية الصحية
TECHNOLOGY تكنولوجيا
TRAVEL سفر
OTHER غير ذلك
ARTS_AND_ENTERTAINMENT فنون وترفيه
BEAUTY_AND_FITNESS جمال ولياقة بدنية
BOOKS_AND_LITERATURE كتب وآداب
FOOD_AND_DRINK مأكولات ومشروبات
GAMES الألعاب
HOBBIES_AND_LEISURE هوايات وتسلية
HOME_AND_GARDEN المنازل والحدائق
INTERNET_AND_TELECOM إنترنت واتصالات
LAW_AND_GOVERNMENT قوانين وحكومات
NEWS أخبار
ONLINE_COMMUNITIES مجتمعات الإنترنت
PEOPLE_AND_SOCIETY أشخاص ومجتمع
PETS_AND_ANIMALS حيوانات أليفة وحيوانات أخرى
REAL_ESTATE العقارات
REFERENCE مراجع
SCIENCE علوم
SPORTS رياضة
JOBS_AND_EDUCATION وظائف وتعليم
SHOPPING تسوّق

KeyEvent

حدث رئيسي في موقع على "إحصاءات Google"

الحقول
name

string

النتائج فقط. اسم المورد لهذا الحدث الرئيسي التنسيق: properties/{property}/keyEvents/{key_event}
event_name

string

غير قابل للتغيير اسم الحدث الرئيسي هذا أمثلة: "click" و"purchase"
create_time

Timestamp

النتائج فقط. الوقت الذي تم فيه إنشاء هذا الحدث الرئيسي في الموقع
deletable

bool

النتائج فقط. إذا تم ضبطها على "صحيح"، يمكن حذف هذا الحدث.
custom

bool

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

CountingMethod

الحقل مطلوب. الطريقة التي سيتمّ بها احتساب الأحداث الرئيسية على مستوى أحداث متعدّدة ضِمن جلسة واحدة
default_value

DefaultValue

اختياريّ. تحدّد هذه السمة قيمة/عملة تلقائية لحدث رئيسي.

CountingMethod

الطريقة التي سيتمّ بها احتساب الأحداث الرئيسية على مستوى أحداث متعدّدة ضِمن جلسة واحدة

عمليات التعداد
COUNTING_METHOD_UNSPECIFIED لم يتم تحديد طريقة الاحتساب.
ONCE_PER_EVENT يُعدّ كل مثيل من "حدث" حدثًا رئيسيًا.
ONCE_PER_SESSION يُعدّ مثيل الحدث حدثًا رئيسيًا مرة واحدة على الأكثر لكل جلسة لكل مستخدم.

DefaultValue

تحدّد هذه السمة قيمة/عملة تلقائية لحدث رئيسي.

الحقول
numeric_value

double

الحقل مطلوب. سيتم استخدام هذه القيمة لتعبئة المَعلمة "القيمة" لجميع مرات حدوث هذا الحدث الرئيسي (المحدّد بواسطة event_name) التي لم يتم ضبط هذه المَعلمة فيها.
currency_code

string

الحقل مطلوب. عندما لا يكون هناك عملة محدّدة لظهور هذا الحدث الرئيسي (المحدّد بواسطة event_name)، سيتم تطبيق هذه العملة كعملة تلقائية. يجب أن يكون بالتنسيق ISO 4217 لرمز العملة.

لمزيد من المعلومات، يُرجى الانتقال إلى https://en.wikipedia.org/wiki/ISO_4217.

ListAccountSummariesRequest

رسالة الطلب الخاصة بإجراء ListAccountSummaries RPC.

الحقول
page_size

int32

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

string

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

ListAccountSummariesResponse

رسالة الردّ على إجراء ListAccountSummaries عن بُعد

الحقول
account_summaries[]

AccountSummary

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

string

رمز مميز يمكن إرساله كـ page_token لاسترداد الصفحة التالية. في حال حذف هذا الحقل، لن تكون هناك صفحات لاحقة.

ListAccountsRequest

رسالة الطلب الخاصة باستدعاء إجراء ListAccounts عن بُعد (RPC).

الحقول
page_size

int32

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

string

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

bool

تحديد ما إذا كان سيتم تضمين الحسابات المحذوفة أوّليًا (أي "المحذوفة") في النتائج يمكن فحص الحسابات لتحديد ما إذا تم حذفها أم لا.

ListAccountsResponse

رسالة الطلب لإجراء ListAccounts عن بُعد (RPC).

الحقول
accounts[]

Account

النتائج التي كان بإمكان المتصل الوصول إليها
next_page_token

string

رمز مميز يمكن إرساله كـ page_token لاسترداد الصفحة التالية. في حال حذف هذا الحقل، لن تكون هناك صفحات لاحقة.

ListConversionEventsRequest

رسالة الطلب لإجراء ListConversionEvents RPC

الحقول
parent

string

الحقل مطلوب. اسم المورد الخاص بالخاصية الرئيسية مثال: 'properties/123'
page_size

int32

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

string

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

ListConversionEventsResponse

رسالة الردّ على إجراء ListConversionEvents RPC.

الحقول
conversion_events[]

ConversionEvent

أحداث الإحالات الناجحة المطلوبة
next_page_token

string

رمز مميز يمكن إرساله كـ page_token لاسترداد الصفحة التالية. في حال حذف هذا الحقل، لن تكون هناك صفحات لاحقة.

ListCustomDimensionsRequest

طلب رسالة لـ ListCustomDimensions RPC.

الحقول
parent

string

الحقل مطلوب. مثال على التنسيق: properties/1234
page_size

int32

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

string

اختياريّ. رمز مميز للصفحة تم تلقّيه من طلب ListCustomDimensions سابق. يجب تقديم هذا الرمز لاسترداد الصفحة التالية.

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

ListCustomDimensionsResponse

رسالة الردّ على إجراء ListCustomDimensions RPC

الحقول
custom_dimensions[]

CustomDimension

قائمة CustomDimensions.
next_page_token

string

رمز مميز يمكن إرساله كـ page_token لاسترداد الصفحة التالية. في حال حذف هذا الحقل، لن تكون هناك صفحات لاحقة.

ListCustomMetricsRequest

رسالة الطلب الخاصة باستدعاء إجراء ListCustomMetrics عن بُعد.

الحقول
parent

string

الحقل مطلوب. مثال على التنسيق: properties/1234
page_size

int32

الحد الأقصى لعدد الموارد المطلوب عرضها إذا لم يتم تحديدها، سيتم عرض 50 موردًا كحد أقصى. الحدّ الأقصى للقيمة هو 200 (سيتم فرض الحدّ الأقصى على القيم الأعلى).
page_token

string

رمز مميز للصفحة تم تلقّيه من طلب ListCustomMetrics سابق. يجب تقديم هذا الرمز لاسترداد الصفحة التالية.

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

ListCustomMetricsResponse

رسالة الردّ على ListCustomMetrics RPC.

الحقول
custom_metrics[]

CustomMetric

قائمة CustomMetrics
next_page_token

string

رمز مميز يمكن إرساله كـ page_token لاسترداد الصفحة التالية. في حال حذف هذا الحقل، لن تكون هناك صفحات لاحقة.

ListDataStreamsRequest

رسالة الطلب الخاصة بإجراء ListDataStreams RPC.

الحقول
parent

string

الحقل مطلوب. مثال على التنسيق: properties/1234
page_size

int32

الحد الأقصى لعدد الموارد المطلوب عرضها إذا لم يتم تحديدها، سيتم عرض 50 موردًا كحد أقصى. الحدّ الأقصى للقيمة هو 200 (سيتم فرض الحدّ الأقصى على القيم الأعلى).
page_token

string

رمز مميز للصفحة تم تلقّيه من طلب ListDataStreams سابق. يجب تقديم هذا الرمز لاسترداد الصفحة التالية.

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

ListDataStreamsResponse

رسالة الردّ على إجراء ListDataStreams عن بُعد

الحقول
data_streams[]

DataStream

قائمة بمصادر البيانات.
next_page_token

string

رمز مميز يمكن إرساله كـ page_token لاسترداد الصفحة التالية. في حال حذف هذا الحقل، لن تكون هناك صفحات لاحقة.

ListFirebaseLinksRequest

رسالة الطلب لاستدعاء إجراء ListFirebaseLinks عن بُعد

الحقول
parent

string

الحقل مطلوب. التنسيق: properties/{property_id}

مثلاً: properties/1234
page_size

int32

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

string

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

ListFirebaseLinksResponse

رسالة الردّ على استدعاء إجراء عن بُعد (RPC) الخاص بـ ListFirebaseLinks

الحقول
next_page_token

string

رمز مميز يمكن إرساله كـ page_token لاسترداد الصفحة التالية. في حال حذف هذا الحقل، لن تكون هناك صفحات لاحقة. في الوقت الحالي، لا تتيح "إحصاءات Google" سوى FirebaseLink واحد لكل موقع، لذا لن يتم ملء هذا الحقل أبدًا.

ListGoogleAdsLinksRequest

رسالة الطلب لإجراء ListGoogleAdsLinks عن بُعد (RPC).

الحقول
parent

string

الحقل مطلوب. مثال على التنسيق: properties/1234
page_size

int32

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

string

اختياريّ. رمز مميز للصفحة تم تلقّيه من طلب ListGoogleAdsLinks سابق. يجب تقديم هذا الرمز لاسترداد الصفحة التالية.

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

ListGoogleAdsLinksResponse

رسالة الردّ على إجراء ListGoogleAdsLinks عن بُعد.

الحقول
next_page_token

string

رمز مميز يمكن إرساله كـ page_token لاسترداد الصفحة التالية. في حال حذف هذا الحقل، لن تكون هناك صفحات لاحقة.

ListKeyEventsRequest

رسالة الطلب لإجراء ListKeyEvents عن بُعد

الحقول
parent

string

الحقل مطلوب. اسم المورد الخاص بالخاصية الرئيسية مثال: 'properties/123'
page_size

int32

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

string

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

ListKeyEventsResponse

رسالة الردّ على إجراء ListKeyEvents عن بُعد

الحقول
key_events[]

KeyEvent

الأحداث الرئيسية المطلوبة
next_page_token

string

رمز مميز يمكن إرساله كـ page_token لاسترداد الصفحة التالية. في حال حذف هذا الحقل، لن تكون هناك صفحات لاحقة.

ListMeasurementProtocolSecretsRequest

رسالة الطلب لاستدعاء إجراء ListMeasurementProtocolSecret عن بُعد

الحقول
parent

string

الحقل مطلوب. اسم المورد لمجموعة البث الرئيسية. التنسيق: properties/{property}/dataStreams/{dataStream}/measurementProtocolSecrets
page_size

int32

اختياريّ. الحد الأقصى لعدد الموارد المطلوب عرضها إذا لم يتم تحديد عدد، سيتم عرض 10 موارد على الأكثر. الحد الأقصى للقيمة هو 10. سيتم فرض القيم الأعلى لتصبح الحد الأقصى.
page_token

string

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

ListMeasurementProtocolSecretsResponse

رسالة الردّ على استدعاء إجراء عن بُعد ListMeasurementProtocolSecret

الحقول
measurement_protocol_secrets[]

MeasurementProtocolSecret

تمثّل هذه السمة قائمة بالعبارات السرية للحدث الرئيسي المحدّد في الطلب.
next_page_token

string

رمز مميز يمكن إرساله كـ page_token لاسترداد الصفحة التالية. في حال حذف هذا الحقل، لن تكون هناك صفحات لاحقة.

ListPropertiesRequest

طلب رسالة لإجراء ListProperties عن بُعد

الحقول
filter

string

الحقل مطلوب. تعبير لفلترة نتائج الطلب. الحقول المؤهَّلة للفلترة هي: parent:(اسم المورد للحساب الرئيسي أو الموقع الرئيسي) أو ancestor:(اسم المورد للحساب الرئيسي) أو firebase_project:(رقم تعريف مشروع Firebase المرتبط). في ما يلي بعض الأمثلة على الفلاتر:

| Filter                      | Description                               |
|-----------------------------|-------------------------------------------|
| parent:accounts/123         | The account with account id: 123.       |
| parent:properties/123       | The property with property id: 123.       |
| ancestor:accounts/123       | The account with account id: 123.         |
| firebase_project:project-id | The firebase project with id: project-id. |
| firebase_project:123        | The firebase project with number: 123.    |
page_size

int32

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

string

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

bool

تحديد ما إذا كان سيتم تضمين المواقع المحذوفة مؤقتًا (أي "الموضوعة في المهملات") في النتائج يمكن فحص المواقع لتحديد ما إذا تم حذفها أم لا.

ListPropertiesResponse

رسالة الردّ على إجراء ListProperties عن بُعد.

الحقول
properties[]

Property

النتائج التي تطابقت مع معايير الفلتر وكان بإمكان المتصل الوصول إليها
next_page_token

string

رمز مميز يمكن إرساله كـ page_token لاسترداد الصفحة التالية. في حال حذف هذا الحقل، لن تكون هناك صفحات لاحقة.

MeasurementProtocolSecret

قيمة سرّية تُستخدَم لإرسال الزيارات إلى Measurement Protocol.

الحقول
name

string

المعرّف. اسم مورد هذا المفتاح السرّي. قد يكون هذا السرّ عنصرًا فرعيًا لأي نوع من أنواع البث. التنسيق: properties/{property}/dataStreams/{dataStream}/measurementProtocolSecrets/{measurementProtocolSecret}
display_name

string

الحقل مطلوب. الاسم المعروض لهذا المفتاح السري الذي يمكن لشخص عادي قراءته
secret_value

string

النتائج فقط. القيمة السرية لبروتوكول القياس. مرِّر هذه القيمة إلى حقل api_secret في واجهة برمجة التطبيقات Measurement Protocol عند إرسال الزيارات إلى الموقع الأصل لهذه الواجهة السرية.

NumericValue

لتمثيل رقم

الحقول
حقل الربط one_value يمكن أن تكون إحدى القيم الرقمية one_value إحدى القيم التالية فقط:
int64_value

int64

قيمة العدد الصحيح
double_value

double

قيمة مزدوجة

الموقع

رسالة مورد تمثّل موقعًا على "إحصاءات Google".

الحقول
name

string

المعرّف. اسم المورد لهذه الموقع. التنسيق: properties/{property_id} مثال: "properties/1000"
property_type

PropertyType

غير قابل للتغيير تمثّل هذه السمة نوع الموقع الخاص بمورد الموقع هذا. عند إنشاء سمة، إذا كان النوع هو "PROPERTY_TYPE_UNSPECIFIED"، سيتمّ ضِمنيًا استخدام "ORDINARY_PROPERTY".
create_time

Timestamp

النتائج فقط. الوقت الذي تم فيه إنشاء الكيان في الأصل
update_time

Timestamp

النتائج فقط. الوقت الذي تم فيه آخر تعديل لحقول حمولة الكيان
parent

string

غير قابل للتغيير اسم مصدر الموقع الرئيسي المنطقي لهذا الموقع

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

string

الحقل مطلوب. الاسم المعروض لهذا الموقع والذي يمكن لشخص عادي قراءته

الحد الأقصى لطول الاسم المعروض المسموح به هو 100 وحدة ترميز UTF-16.
industry_category

IndustryCategory

الصناعة المرتبطة بهذه المؤسسة. مثال: AUTOMOTIVE أو FOOD_AND_DRINK
time_zone

string

الحقل مطلوب. المنطقة الزمنية لإعداد التقارير، والتي تُستخدَم كحدّ اليوم للتقارير، بغض النظر عن مصدر البيانات إذا كانت المنطقة الزمنية تستخدم التوقيت الصيفي، ستتكيّف "إحصاءات Google" مع التغييرات تلقائيًا.

ملاحظة: لا يؤثر تغيير المنطقة الزمنية إلا في البيانات الجديدة، ولا يسري بمفعول رجعي.

التنسيق: https://www.iana.org/time-zones مثال: "America/Los_Angeles"
currency_code

string

نوع العملة المستخدَمة في التقارير التي تتضمّن قيمًا نقدية

التنسيق: https://en.wikipedia.org/wiki/ISO_4217 أمثلة: "USD" و"EUR" و"JPY"
service_level

ServiceLevel

النتائج فقط. مستوى خدمة "إحصاءات Google" الذي ينطبق على هذا الموقع
delete_time

Timestamp

النتائج فقط. في حال ضبطها، تمثّل هذه السمة الوقت الذي تم فيه نقل هذا الموقع إلى المهملات. إذا لم يتم ضبطها، يعني ذلك أنّ هذا الموقع ليس في المهملات حاليًا.
expire_time

Timestamp

النتائج فقط. في حال ضبطها، تمثّل هذه السمة الوقت الذي سيتم فيه حذف الموقع نهائيًا من المهملات. إذا لم يتم ضبط هذه السمة، يعني ذلك أنّ الموقع ليس حاليًا في المهملات ولا يُفترض أن يتم حذفه.
account

string

غير قابل للتغيير اسم مورد الحساب الرئيسي، التنسيق: accounts/{account_id}، مثال: "accounts/123"

PropertySummary

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

الحقول
property

string

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

string

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

PropertyType

نوع الموقع
parent

string

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

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

bool

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

PropertyType

أنواع موارد Property

عمليات التعداد
PROPERTY_TYPE_UNSPECIFIED نوع الموقع غير معروف أو غير محدّد
PROPERTY_TYPE_ORDINARY موقع عادي على "إحصاءات Google"
PROPERTY_TYPE_SUBPROPERTY موقع فرعي على "إحصاءات Google"
PROPERTY_TYPE_ROLLUP موقع بيانات مجمّعة على "إحصاءات Google"

ProvisionAccountTicketRequest

رسالة الطلب الخاصة بإجراء ProvisionAccountTicket RPC.

الحقول
account

Account

الحساب المطلوب إنشاؤه.
redirect_uri

string

معرّف الموارد المنتظم (URI) لإعادة التوجيه الذي سيتم إرسال المستخدم إليه بعد قبول بنود الخدمة. يجب ضبطه في Cloud Console كمعرّف موارد منتظم (URI) لإعادة التوجيه.

ProvisionAccountTicketResponse

رسالة الردّ على إجراء ProvisionAccountTicket RPC.

الحقول
account_ticket_id

string

المَعلمة التي سيتم تمريرها في رابط بنود الخدمة

RunAccessReportRequest

طلب الحصول على تقرير سجلّ الوصول إلى البيانات

الحقول
entity

string

يتيح "تقرير الوصول إلى البيانات" تقديم الطلبات على مستوى الموقع أو الحساب. إذا تمّ طلبها على مستوى الحساب، ستتضمّن تقارير "الوصول إلى البيانات" جميع عمليات الوصول إلى جميع المواقع ضِمن هذا الحساب.

لتقديم الطلب على مستوى الموقع، يجب أن يكون العنصر مثلاً "properties/123" إذا كان "123" هو رقم تعريف موقعك على "إحصاءات Google". لتقديم الطلب على مستوى الحساب، يجب أن يكون العنصر مثلاً "accounts/1234" إذا كان "1234" هو معرّف حسابك على "إحصاءات Google".
dimensions[]

AccessDimension

السمات المطلوبة والمعروضة في الردّ يُسمح بتقديم طلبات تصل إلى 9 سمات.
metrics[]

AccessMetric

المقاييس المطلوبة والمعروضة في الردّ يُسمح بطلبات تصل إلى 10 مقاييس.
date_ranges[]

AccessDateRange

النطاقات الزمنية لسجلات الوصول التي سيتم قراءتها في حال طلب نطاقات زمنية متعدّدة، سيحتوي كل صف من صفوف الردود على فهرس نطاق زمني يبدأ من الصفر. في حال تداخل نطاقَين زمنيَين، يتم تضمين سجلّات الوصول للأيام المتداخلة في صفوف الردّ لكلا النطاقَين الزمنيَين. يُسمح بطلب نطاقَين زمنيَين كحدّ أقصى.
dimension_filter

AccessFilterExpression

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

AccessFilterExpression

تسمح لك فلاتر المقاييس بحصر استجابة التقرير على قيم مقاييس معيّنة تتطابق مع الفلتر. يتم تطبيق فلاتر المقاييس بعد تجميع صفوف التقرير، على غرار عبارة SQL having-clause. لا يمكن استخدام السمات في هذا الفلتر.
offset

int64

عدد الصفوف في صف البداية. يتم احتساب الصف الأول على أنّه الصف 0. إذا لم يتم تحديد الإزاحة، سيتم التعامل معها على أنّها 0. إذا كان الإزاحة صفرًا، ستعرض هذه الطريقة الصفحة الأولى من النتائج التي تتضمّن limit إدخالاً.

لمزيد من المعلومات عن مَعلمة التقسيم على صفحات، اطّلِع على التقسيم على صفحات.
limit

int64

عدد الصفوف المطلوب عرضها. إذا لم يتم تحديدها، سيتم عرض 10,000 صف. تعرض واجهة برمجة التطبيقات 100,000 صف كحدّ أقصى لكلّ طلب، بغضّ النظر عن عدد الصفوف التي تطلبها. يجب أن تكون قيمة limit موجبة.

قد تعرض واجهة برمجة التطبيقات عددًا من الصفوف أقل من limit المطلوب، إذا لم يكن هناك عدد من الصفوف المتبقية يساوي limit. على سبيل المثال، هناك أقل من 300 قيمة محتملة للسمة country، لذا عند إعداد التقارير عن country فقط، لا يمكنك الحصول على أكثر من 300 صف، حتى إذا ضبطت limit على قيمة أعلى.

لمزيد من المعلومات عن مَعلمة التقسيم على صفحات، اطّلِع على التقسيم على صفحات.
time_zone

string

تمثّل هذه السمة المنطقة الزمنية للطلب، إذا تم تحديدها. في حال عدم تحديدها، يتم استخدام المنطقة الزمنية للموقع. تُستخدَم المنطقة الزمنية للطلب لتفسير تاريخَي بدء التقرير وانتهائه.

يتم تنسيقها كسلاسل من قاعدة بيانات المناطق الزمنية IANA (https://www.iana.org/time-zones)، مثلاً "America/New_York" أو "Asia/Tokyo".
order_bys[]

AccessOrderBy

تحدّد هذه السمة كيفية ترتيب الصفوف في الردّ.
return_entity_quota

bool

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

bool

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

bool

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

RunAccessReportResponse

الردّ المخصّص على "تقرير سجلّ الوصول إلى البيانات"

الحقول
dimension_headers[]

AccessDimensionHeader

عنوان العمود في التقرير الذي يتوافق مع سمة معيّنة. يتطابق عدد DimensionHeaders وترتيبها مع الأبعاد المتوفّرة في الصفوف.
metric_headers[]

AccessMetricHeader

عنوان عمود في التقرير يتوافق مع مقياس معيّن. يتطابق عدد MetricHeaders وترتيبها مع المقاييس المتوفّرة في الصفوف.
rows[]

AccessRow

صفوف تتضمّن مجموعات من قيم السمات وقيم المقاييس في التقرير
row_count

int32

تمثّل هذه السمة إجمالي عدد الصفوف في نتيجة طلب البحث. إنّ rowCount مستقل عن عدد الصفوف المعروضة في الاستجابة، ومَعلمة الطلب limit، ومَعلمة الطلب offset. على سبيل المثال، إذا عرض طلب بحث 175 صفًا وتضمّن limit من 50 في طلب بيانات من واجهة برمجة التطبيقات، ستحتوي الاستجابة على rowCount من 175 ولكن 50 صفًا فقط.

لمزيد من المعلومات عن مَعلمة التقسيم على صفحات، اطّلِع على التقسيم على صفحات.
quota

AccessQuota

حالة الحصة لهذا الموقع على "إحصاءات Google"، بما في ذلك هذا الطلب لا يعمل هذا الحقل مع الطلبات على مستوى الحساب.

SearchChangeHistoryEventsRequest

رسالة الطلب الخاصة بـ SearchChangeHistoryEvents RPC

الحقول
account

string

الحقل مطلوب. مورد الحساب المطلوب عرض موارد سجلّ التغييرات له. التنسيق: accounts/{account}

مثلاً: accounts/100
property

string

اختياريّ. اسم المورد لموقع فرعي في حال ضبطها، لن يتم عرض سوى التغييرات التي تم إجراؤها على هذه السمة أو مواردها الفرعية. التنسيق: properties/{propertyId}

مثلاً: properties/100
resource_type[]

ChangeHistoryResourceType

اختياريّ. في حال ضبطها، لا تعرض التغييرات إلا إذا كانت خاصة بمورد يتطابق مع نوع واحد على الأقل من هذه الأنواع.
action[]

ActionType

اختياريّ. في حال ضبطها، لن يتم عرض سوى التغييرات التي تتطابق مع نوع واحد أو أكثر من أنواع الإجراءات هذه.
actor_email[]

string

اختياريّ. في حال ضبطها، لن يتم عرض التغييرات إلا إذا أجراها مستخدم في هذه القائمة.
earliest_change_time

Timestamp

اختياريّ. في حال ضبط هذا الخيار، لن يتم عرض سوى التغييرات التي تم إجراؤها بعد هذا الوقت (بما في ذلك).
latest_change_time

Timestamp

اختياريّ. في حال ضبطها، سيتم عرض التغييرات التي تم إجراؤها قبل هذا الوقت فقط (بما في ذلك).
page_size

int32

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

يُرجى العِلم أنّ الخدمة قد تعرض صفحة تتضمّن عددًا أقل من العناصر التي تحدّدها هذه القيمة (وربما لا تتضمّن أي عناصر)، وقد تظل هناك صفحات إضافية. إذا كنت تريد عددًا معيّنًا من العناصر، عليك مواصلة طلب صفحات إضافية باستخدام page_token إلى أن تحصل على العدد المطلوب.
page_token

string

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

SearchChangeHistoryEventsResponse

رسالة الردّ على إجراء SearchAccounts RPC.

الحقول
change_history_events[]

ChangeHistoryEvent

النتائج التي كان بإمكان المتصل الوصول إليها
next_page_token

string

رمز مميز يمكن إرساله كـ page_token لاسترداد الصفحة التالية. في حال حذف هذا الحقل، لن تكون هناك صفحات لاحقة.

ServiceLevel

مستويات مختلفة من الخدمة في "إحصاءات Google"

عمليات التعداد
SERVICE_LEVEL_UNSPECIFIED لم يتم تحديد مستوى الخدمة أو أنّه غير صالح.
GOOGLE_ANALYTICS_STANDARD الإصدار العادي من "إحصاءات Google"
GOOGLE_ANALYTICS_360 الإصدار المدفوع والمميّز من "إحصاءات Google"

UpdateAccountRequest

رسالة الطلب لإجراء UpdateAccount RPC.

الحقول
account

Account

الحقل مطلوب. الحساب المطلوب تعديله. يُستخدَم حقل name الخاص بالحساب لتحديد الحساب.
update_mask

FieldMask

الحقل مطلوب. قائمة الحقول التي سيتم تعديلها. يجب أن تكون أسماء الحقول بتنسيق snake case (على سبيل المثال، "field_to_update"). لن يتم تعديل الحقول المحذوفة. لاستبدال الكيان بأكمله، استخدِم مسارًا واحدًا مع السلسلة "*" لمطابقة جميع الحقول.

UpdateConversionEventRequest

رسالة الطلب لإجراء UpdateConversionEvent عن بُعد

الحقول
conversion_event

ConversionEvent

الحقل مطلوب. حدث الإحالة الناجحة المطلوب تعديله. يُستخدَم الحقل name لتحديد الإعدادات التي سيتم تعديلها.
update_mask

FieldMask

الحقل مطلوب. قائمة الحقول التي سيتم تعديلها. يجب أن تكون أسماء الحقول في حالة الثعبان (على سبيل المثال، "field_to_update"). لن يتم تعديل الحقول المحذوفة. لاستبدال الكيان بأكمله، استخدِم مسارًا واحدًا مع السلسلة "*" لمطابقة جميع الحقول.

UpdateCustomDimensionRequest

طلب رسالة لـ UpdateCustomDimension RPC.

الحقول
custom_dimension

CustomDimension

السمة المخصّصة التي سيتم تعديلها
update_mask

FieldMask

الحقل مطلوب. قائمة الحقول التي سيتم تعديلها. لن يتم تعديل الحقول المحذوفة. لاستبدال الكيان بأكمله، استخدِم مسارًا واحدًا مع السلسلة "*" لمطابقة جميع الحقول.

UpdateCustomMetricRequest

رسالة الطلب لإجراء UpdateCustomMetric RPC.

الحقول
custom_metric

CustomMetric

CustomMetric المطلوب تعديله
update_mask

FieldMask

الحقل مطلوب. قائمة الحقول التي سيتم تعديلها. لن يتم تعديل الحقول المحذوفة. لاستبدال الكيان بأكمله، استخدِم مسارًا واحدًا مع السلسلة "*" لمطابقة جميع الحقول.

UpdateDataRetentionSettingsRequest

رسالة الطلب الخاصة باستدعاء إجراء UpdateDataRetentionSettings عن بُعد (RPC).

الحقول
data_retention_settings

DataRetentionSettings

الحقل مطلوب. الإعدادات المطلوب تعديلها يُستخدَم الحقل name لتحديد الإعدادات التي سيتم تعديلها.
update_mask

FieldMask

الحقل مطلوب. قائمة الحقول التي سيتم تعديلها. يجب أن تكون أسماء الحقول في حالة الثعبان (على سبيل المثال، "field_to_update"). لن يتم تعديل الحقول المحذوفة. لاستبدال الكيان بأكمله، استخدِم مسارًا واحدًا مع السلسلة "*" لمطابقة جميع الحقول.

UpdateDataStreamRequest

طلب رسالة لـ UpdateDataStream RPC.

الحقول
data_stream

DataStream

معرّف DataStream المطلوب تعديله
update_mask

FieldMask

الحقل مطلوب. قائمة الحقول التي سيتم تعديلها. لن يتم تعديل الحقول المحذوفة. لاستبدال الكيان بأكمله، استخدِم مسارًا واحدًا مع السلسلة "*" لمطابقة جميع الحقول.

UpdateGoogleAdsLinkRequest

رسالة الطلب الخاصة باستدعاء إجراء UpdateGoogleAdsLink عن بُعد

الحقول
update_mask

FieldMask

الحقل مطلوب. قائمة الحقول التي سيتم تعديلها. يجب أن تكون أسماء الحقول في حالة الثعبان (على سبيل المثال، "field_to_update"). لن يتم تعديل الحقول المحذوفة. لاستبدال الكيان بأكمله، استخدِم مسارًا واحدًا مع السلسلة "*" لمطابقة جميع الحقول.

UpdateKeyEventRequest

رسالة الطلب لإجراء UpdateKeyEvent RPC

الحقول
key_event

KeyEvent

الحقل مطلوب. الحدث الرئيسي المطلوب تعديله. يُستخدَم الحقل name لتحديد الإعدادات التي سيتم تعديلها.
update_mask

FieldMask

الحقل مطلوب. قائمة الحقول التي سيتم تعديلها. يجب أن تكون أسماء الحقول في حالة الثعبان (على سبيل المثال، "field_to_update"). لن يتم تعديل الحقول المحذوفة. لاستبدال الكيان بأكمله، استخدِم مسارًا واحدًا مع السلسلة "*" لمطابقة جميع الحقول.

UpdateMeasurementProtocolSecretRequest

رسالة الطلب لإجراء UpdateMeasurementProtocolSecret RPC

الحقول
measurement_protocol_secret

MeasurementProtocolSecret

الحقل مطلوب. المفتاح السرّي لبروتوكول القياس المطلوب تعديله.
update_mask

FieldMask

الحقل مطلوب. قائمة الحقول التي سيتم تعديلها. لن يتم تعديل الحقول المحذوفة.

UpdatePropertyRequest

رسالة الطلب لإجراء UpdateProperty عن بُعد

الحقول
property

Property

الحقل مطلوب. الموقع المطلوب تعديله يُستخدَم الحقل name الخاص بالسمة لتحديد السمة التي سيتم تعديلها.
update_mask

FieldMask

الحقل مطلوب. قائمة الحقول التي سيتم تعديلها. يجب أن تكون أسماء الحقول في حالة الثعبان (على سبيل المثال، "field_to_update"). لن يتم تعديل الحقول المحذوفة. لاستبدال الكيان بأكمله، استخدِم مسارًا واحدًا مع السلسلة "*" لمطابقة جميع الحقول.