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)

تنشئ سمة مخصّصة.

نطاقات التفويض

يجب توفير نطاق 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)

لإنشاء مصدر بيانات

نطاقات التفويض

يجب توفير نطاق 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)

ابحث عن سمة مخصّصة واحدة.

نطاقات التفويض

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

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

rpc GetCustomMetric(GetCustomMetricRequest) returns (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)

يُدرج CustomDimensions في موقع.

نطاقات التفويض

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

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

rpc ListCustomMetrics(ListCustomMetricsRequest) returns (ListCustomMetricsResponse)

يُدرج CustomMetrics في موقع.

نطاقات التفويض

يتطلب أحد نطاقات 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)

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

نطاقات التفويض

يتطلب أحد نطاقات 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" ومنتجات أخرى مثل 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

نطاق متّصل من الأيام: تاريخ البدء، وتاريخ البدء + 1، و...، وتاريخ الانتهاء

الحقول
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

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

الحقول
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

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

AccessFilterExpressionList

ترتبط كلّ تعبيرات الفلتر في المجموعة 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

اسم المقياس، على سبيل المثال "عدد_عمليات_الوصول".

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

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

الحقول
desc

bool

إذا كان صحيحًا، يتم الترتيب تنازليًا. إذا كان خطأ أو غير محدّد، يتم الفرز بترتيب تصاعدي.
حقل الربط 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" < "أ" < "س" < "ب" < "ز".
CASE_INSENSITIVE_ALPHANUMERIC ترتيب أبجدي رقمي غير حسّاس لحالة الأحرف حسب قيمة موضع رمز يونيكود بحالة الأحرف الصغيرة على سبيل المثال، "2" < "أ" < "ب" < "س" < "ص".
NUMERIC يتم تحويل قيم السمات إلى أرقام قبل الترتيب. على سبيل المثال، في الترتيب NUMERIC، "25" < "100"، وفي الترتيب ALPHANUMERIC، "100" < "25". تكون قيم السمات غير الرقمية متساوية من حيث الترتيب أسفل جميع القيم الرقمية.

MetricOrderBy

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

الحقول
metric_name

string

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

AccessQuota

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

الحقول
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

النتائج فقط. عنوان URL لمورد مؤسسة على "منصة 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

رسالة طلب لطلب إجراء معالجة طلب برمجي (RPC) من نوع AcknowledgeUserDataCollection

الحقول
property

string

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

string

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

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

AcknowledgeUserDataCollectionResponse

لا يحتوي هذا النوع على أي حقول.

رسالة الاستجابة لطلب RPC الخاص بـ AcknowledgeUserDataCollection

ActionType

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

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

ActorType

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

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

ArchiveCustomDimensionRequest

رسالة طلب لإجراء طلب بحث برمجي (RPC) من أجل ArchiveCustomDimension

الحقول
name

string

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

ArchiveCustomMetricRequest

رسالة طلب لإجراء طلب RPC في 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

إذا كانت القيمة صحيحة، يعني ذلك أنّه تمّ فلترة قائمة التغييرات المعروضة، وأنّها لا تمثّل جميع التغييرات التي حدثت في هذا الحدث.
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

النتائج فقط. في حال ضبطها على "صحيح"، يشير حدث الإحالة الناجحة هذا إلى حدث مخصّص. في حال ضبطه على false، يشير حدث الإحالة الناجحة هذا إلى حدث تلقائي في "إحصاءات 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

ستُستخدَم هذه القيمة لتعبئة قيمة جميع الإحالات الناجحة التي تحمل اسم_الحدث المحدّد حيث لم يتم ضبط مَعلمة الحدث "value".
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 RPC

الحقول
parent

string

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

CustomDimension

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

CreateCustomMetricRequest

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

الحقول
parent

string

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

CustomMetric

مطلوب. مقياس CustomMetric المطلوب إنشاؤه.

CreateDataStreamRequest

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

الحقول
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

الحقول
parent

string

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

MeasurementProtocolSecret

مطلوب. مفتاح سرّ Measurement Protocol المطلوب إنشاؤه

CreatePropertyRequest

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

الحقول
property

Property

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

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

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

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

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. يجب ترك هذا الحقل فارغًا للمقاييس التي تستخدم وحدة قياس غير "العملة".

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 شهرًا. تتوفّر هذه الميزة لمواقع 360 فقط. تتوفّر هذه السمة لبيانات الأحداث فقط.
THIRTY_EIGHT_MONTHS تبلغ مدة الاحتفاظ بالبيانات 38 شهرًا. تتوفّر هذه الميزة لمواقع 360 فقط. تتوفّر هذه السمة لبيانات الأحداث فقط.
FIFTY_MONTHS تبلغ مدة الاحتفاظ بالبيانات 50 شهرًا. تتوفّر هذه الميزة لمواقع 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 الأخرى المخصّصة للأنشطة التجارية.

يتمّ ربط هذا الحقل بحقل "اقتراحات لنشاطك التجاري" في واجهة مستخدِم "إحصاءات 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

مطلوب. غير قابل للتغيير نوع مورد DataStream هذا.
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

رسالة طلب لإجراء طلب RPC لحذف الحساب

الحقول
name

string

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

DeleteConversionEventRequest

رسالة طلب لإجراء طلب RPC لحذف حدث الإحالة الناجحة

الحقول
name

string

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

DeleteDataStreamRequest

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

الحقول
name

string

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

DeleteFirebaseLinkRequest

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

الحقول
name

string

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

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

DeleteGoogleAdsLinkRequest

رسالة طلب لإجراء طلب RPC لحذف رابط Google Ads

الحقول
name

string

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

DeleteKeyEventRequest

رسالة طلب لإجراء طلب RPC لحذف مفتاح الحدث

الحقول
name

string

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

DeleteMeasurementProtocolSecretRequest

رسالة طلب لإجراء طلب RPC لحذف MeasurementProtocolSecret

الحقول
name

string

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

DeletePropertyRequest

رسالة طلب لإجراء طلب RPC لحذف العنصر

الحقول
name

string

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

GetAccountRequest

رسالة طلب لطلب إجراء برمجي للاتصال (RPC) من أجل GetAccount

الحقول
name

string

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

GetConversionEventRequest

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

الحقول
name

string

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

GetCustomDimensionRequest

رسالة طلب لطلب إجراء RPC من GetCustomDimension

الحقول
name

string

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

GetCustomMetricRequest

رسالة طلب لطلب إجراء RPC من GetCustomMetric

الحقول
name

string

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

GetDataRetentionSettingsRequest

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

الحقول
name

string

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

GetDataSharingSettingsRequest

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

الحقول
name

string

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

مثلاً: accounts/1000/dataSharingSettings

GetDataStreamRequest

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

الحقول
name

string

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

GetKeyEventRequest

رسالة طلب لطلب إجراء RPC من GetKeyEvent

الحقول
name

string

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

GetMeasurementProtocolSecretRequest

رسالة طلب لطلب إجراء RPC من 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 Shopping

KeyEvent

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

الحقول
name

string

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

string

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

Timestamp

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

bool

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

bool

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

CountingMethod

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

DefaultValue

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

CountingMethod

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

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

DefaultValue

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

الحقول
numeric_value

double

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

string

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

يُرجى الاطّلاع على https://en.wikipedia.org/wiki/ISO_4217 للحصول على مزيد من المعلومات.

ListAccountSummariesRequest

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

الحقول
page_size

int32

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

string

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

ListAccountSummariesResponse

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

الحقول
account_summaries[]

AccountSummary

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

string

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

ListAccountsRequest

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

الحقول
page_size

int32

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

string

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

bool

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

ListAccountsResponse

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

الحقول
accounts[]

Account

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

string

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

ListConversionEventsRequest

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

الحقول
parent

string

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

int32

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

string

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

ListConversionEventsResponse

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

الحقول
conversion_events[]

ConversionEvent

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

string

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

ListCustomDimensionsRequest

رسالة طلب لإجراء طلب بحث برمجي (RPC) في ListCustomDimensions

الحقول
parent

string

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

int32

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

string

رمز مميّز للصفحة، تم تلقّيه من مكالمة ListCustomDimensions سابقة قدِّم هذا المرجع لاسترداد الصفحة اللاحقة.

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

ListCustomDimensionsResponse

رسالة الردّ لطلب بيانات الجلسة ListCustomDimensions

الحقول
custom_dimensions[]

CustomDimension

قائمة السمات المخصّصة
next_page_token

string

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

ListCustomMetricsRequest

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

الحقول
parent

string

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

int32

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

string

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

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

ListCustomMetricsResponse

رسالة الردّ على طلب إجراء RPC في ListCustomMetrics

الحقول
custom_metrics[]

CustomMetric

قائمة المقاييس المخصّصة
next_page_token

string

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

ListDataStreamsRequest

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

الحقول
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

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

الحقول
next_page_token

string

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

ListGoogleAdsLinksRequest

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

الحقول
parent

string

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

int32

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

string

رمز مميّز للصفحة، تم تلقّيه من مكالمة ListGoogleAdsLinks سابقة قدِّم هذا المرجع لاسترداد الصفحة اللاحقة.

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

ListGoogleAdsLinksResponse

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

الحقول
next_page_token

string

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

ListKeyEventsRequest

رسالة طلب لطلب ListKeyEvents RPC

الحقول
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

النتائج فقط. قيمة مفتاح Measurement Protocol السري نقْل هذه القيمة إلى حقل api_secret في Measurement Protocol API عند إرسال نتائج إلى الموقع الرئيسي لهذا السرّ

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"

PropertyType

أنواع موارد Property

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

ProvisionAccountTicketRequest

رسالة طلب لطلب إجراء برمجي (RPC) من أجل ProvisionAccountTicket

الحقول
account

Account

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

string

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

ProvisionAccountTicketResponse

رسالة الردّ على طلب إجراء معالجة طلبات بروتوكول التطبيقات (RPC) من أجل ProvisionAccountTicket

الحقول
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

تسمح لك فلاتر المقاييس بحصر استجابة التقرير في قيم مقاييس معيّنة تتطابق مع الفلتر. يتم تطبيق فلاتر المقاييس بعد تجميع صفوف التقرير، تمامًا مثل عبارة having في لغة الاستعلامات البنيوية (SQL). لا يمكن استخدام السمات في هذا الفلتر.
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)، على سبيل المثال "أمريكا/نيويورك" أو "آسيا/طوكيو".
order_bys[]

AccessOrderBy

تحدِّد كيفية ترتيب الصفوف في الاستجابة.
return_entity_quota

bool

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

bool

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

bool

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

RunAccessReportResponse

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

الحقول
dimension_headers[]

AccessDimensionHeader

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

AccessMetricHeader

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

AccessRow

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

int32

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

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

AccessQuota

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

SearchChangeHistoryEventsRequest

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

الحقول
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 عن بُعد

الحقول
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 عن بُعد

الحقول
account

Account

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

FieldMask

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

UpdateConversionEventRequest

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

الحقول
conversion_event

ConversionEvent

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

FieldMask

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

UpdateCustomDimensionRequest

رسالة طلب لإجراء طلب RPC من أجل UpdateCustomDimension

الحقول
custom_dimension

CustomDimension

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

FieldMask

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

UpdateCustomMetricRequest

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

الحقول
custom_metric

CustomMetric

المقياس المخصّص المطلوب تعديله
update_mask

FieldMask

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

UpdateDataRetentionSettingsRequest

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

الحقول
data_retention_settings

DataRetentionSettings

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

FieldMask

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

UpdateDataStreamRequest

رسالة طلب لطلب إجراء RPC في UpdateDataStream

الحقول
data_stream

DataStream

مصدر البيانات المطلوب تعديله
update_mask

FieldMask

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

UpdateGoogleAdsLinkRequest

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

الحقول
update_mask

FieldMask

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

UpdateKeyEventRequest

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

الحقول
key_event

KeyEvent

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

FieldMask

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

UpdateMeasurementProtocolSecretRequest

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

الحقول
measurement_protocol_secret

MeasurementProtocolSecret

مطلوب. مفتاح Measurement Protocol السري المطلوب تعديله
update_mask

FieldMask

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

UpdatePropertyRequest

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

الحقول
property

Property

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

FieldMask

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