Package google.ads.datamanager.v1

الفهرس

IngestionService

خدمة لإرسال بيانات الجمهور إلى وجهات متوافقة

IngestAdEvents

rpc IngestAdEvents(IngestAdEventsRequest) returns (IngestAdEventsResponse)

تحميل قائمة بموارد AdEvent إلى "إحصاءات Google"

هذه الميزة متاحة فقط للحسابات المُدرَجة في القائمة المسموح بها.

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

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

  • https://www.googleapis.com/auth/datamanager
IngestAudienceMembers

rpc IngestAudienceMembers(IngestAudienceMembersRequest) returns (IngestAudienceMembersResponse)

تحميل قائمة بموارد AudienceMember إلى Destination المقدَّم

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

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

  • https://www.googleapis.com/auth/datamanager
IngestEvents

rpc IngestEvents(IngestEventsRequest) returns (IngestEventsResponse)

تحميل قائمة بموارد Event من Destination المقدَّمة

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

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

  • https://www.googleapis.com/auth/datamanager
IngestUsers

rpc IngestUsers(IngestUsersRequest) returns (IngestUsersResponse)

تحميل قائمة بالمستخدمين إلى الوجهات المقدَّمة على عكس IngestAudienceMembers (التي تضيف المستخدمين إلى قوائم جمهور المعلِنين المحدّدة للاستهداف)، تستوعب IngestUsers بيانات ربط الهوية على مستوى الحساب (مثل معرّفات المستخدمين المرتبطة بمعرّفات الأجهزة الجوّالة) بغض النظر عن شرائح الجمهور المحدّدة.

هذه الميزة متاحة فقط للحسابات المُدرَجة في القائمة المسموح بها.

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

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

  • https://www.googleapis.com/auth/datamanager
RemoveAllAudienceMembers

rpc RemoveAllAudienceMembers(RemoveAllAudienceMembersRequest) returns (RemoveAllAudienceMembersResponse)

تتم إزالة جميع أفراد الجمهور من الوجهات المقدَّمة.

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

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

  • https://www.googleapis.com/auth/datamanager
RemoveAudienceMembers

rpc RemoveAudienceMembers(RemoveAudienceMembersRequest) returns (RemoveAudienceMembersResponse)

تزيل هذه الطريقة قائمة بموارد AudienceMember من Destination المقدَّمة.

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

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

  • https://www.googleapis.com/auth/datamanager
RemoveUsers

rpc RemoveUsers(RemoveUsersRequest) returns (RemoveUsersResponse)

تزيل هذه الطريقة قائمة مستخدمين من الوجهات المقدَّمة.

هذه الميزة متاحة فقط للحسابات المُدرَجة في القائمة المسموح بها.

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

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

  • https://www.googleapis.com/auth/datamanager
RetrieveRequestStatus

rpc RetrieveRequestStatus(RetrieveRequestStatusRequest) returns (RetrieveRequestStatusResponse)

تعرض هذه الطريقة حالة الطلب الذي تمّ إدخال رقم تعريفه.

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

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

  • https://www.googleapis.com/auth/datamanager

MarketingDataInsightsService

خدمة لعرض إحصاءات حول البيانات التسويقية

لا تتوفّر هذه الميزة إلا لشركاء البيانات.

RetrieveInsights

rpc RetrieveInsights(RetrieveInsightsRequest) returns (RetrieveInsightsResponse)

تستردّ هذه الطريقة إحصاءات بيانات التسويق لقائمة مستخدمين معيّنة.

لا تتوفّر هذه الميزة إلا لشركاء البيانات.

عناوين التفويض:

تتيح هذه الطريقة استخدام العناوين الاختيارية التالية لتحديد كيفية منح واجهة برمجة التطبيقات إذن الوصول إلى الطلب:

  • ‫login-account: (اختياري) اسم المورد للحساب الذي يكون فيه حساب Google الخاص ببيانات الاعتماد مستخدمًا. في حال عدم ضبط هذه القيمة، يتم تلقائيًا استخدام حساب الطلب. التنسيق: accountTypes/{loginAccountType}/accounts/{loginAccountId}
  • linked-account: (اختياري) اسم المرجع للحساب الذي تم ربطه بمنتج login-account. التنسيق: accountTypes/{linkedAccountType}/accounts/{linkedAccountId}
نطاقات الأذونات

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

  • https://www.googleapis.com/auth/datamanager

PartnerLinkService

خدمة لإدارة روابط الشركاء

UserListDirectLicenseService

خدمة لإدارة التراخيص المباشرة لقوائم المستخدمين الحذف ليس عملية متاحة لـ UserListDirectLicenses. على المتصلين تعديل حالة الترخيص إلى DISABLED لإيقاف الترخيص بدلاً من ذلك.

لا تتوفّر هذه الميزة إلا لشركاء البيانات.

CreateUserListDirectLicense

rpc CreateUserListDirectLicense(CreateUserListDirectLicenseRequest) returns (UserListDirectLicense)

تنشئ هذه الطريقة ترخيصًا مباشرًا لقائمة مستخدمين.

لا تتوفّر هذه الميزة إلا لشركاء البيانات.

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

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

  • https://www.googleapis.com/auth/datamanager
GetUserListDirectLicense

rpc GetUserListDirectLicense(GetUserListDirectLicenseRequest) returns (UserListDirectLicense)

يستردّ هذا الإجراء ترخيصًا مباشرًا لقائمة مستخدمين.

لا تتوفّر هذه الميزة إلا لشركاء البيانات.

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

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

  • https://www.googleapis.com/auth/datamanager
ListUserListDirectLicenses

rpc ListUserListDirectLicenses(ListUserListDirectLicensesRequest) returns (ListUserListDirectLicensesResponse)

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

لا تتوفّر هذه الميزة إلا لشركاء البيانات.

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

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

  • https://www.googleapis.com/auth/datamanager
UpdateUserListDirectLicense

rpc UpdateUserListDirectLicense(UpdateUserListDirectLicenseRequest) returns (UserListDirectLicense)

تعديل ترخيص مباشر لقائمة مستخدمين

لا تتوفّر هذه الميزة إلا لشركاء البيانات.

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

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

  • https://www.googleapis.com/auth/datamanager

UserListGlobalLicenseService

خدمة لإدارة التراخيص العمومية لقوائم المستخدمين الحذف ليس عملية متاحة لـ UserListGlobalLicenses. على المتصلين تعديل حالة الترخيص إلى DISABLED لإيقاف الترخيص بدلاً من ذلك.

لا تتوفّر هذه الميزة إلا لشركاء البيانات.

CreateUserListGlobalLicense

rpc CreateUserListGlobalLicense(CreateUserListGlobalLicenseRequest) returns (UserListGlobalLicense)

تُنشئ هذه الطريقة ترخيصًا عالميًا لقائمة مستخدمين.

لا تتوفّر هذه الميزة إلا لشركاء البيانات.

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

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

  • https://www.googleapis.com/auth/datamanager
GetUserListGlobalLicense

rpc GetUserListGlobalLicense(GetUserListGlobalLicenseRequest) returns (UserListGlobalLicense)

يستردّ ترخيصًا عالميًا لقائمة مستخدمين.

لا تتوفّر هذه الميزة إلا لشركاء البيانات.

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

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

  • https://www.googleapis.com/auth/datamanager
ListUserListGlobalLicenseCustomerInfos

rpc ListUserListGlobalLicenseCustomerInfos(ListUserListGlobalLicenseCustomerInfosRequest) returns (ListUserListGlobalLicenseCustomerInfosResponse)

تعرِض هذه السمة جميع معلومات العملاء لترخيص عالمي خاص بقائمة مستخدمين.

لا تتوفّر هذه الميزة إلا لشركاء البيانات.

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

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

  • https://www.googleapis.com/auth/datamanager
ListUserListGlobalLicenses

rpc ListUserListGlobalLicenses(ListUserListGlobalLicensesRequest) returns (ListUserListGlobalLicensesResponse)

تعرض هذه السمة جميع التراخيص العامة لقوائم المستخدمين التي يملكها حساب الأهل.

لا تتوفّر هذه الميزة إلا لشركاء البيانات.

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

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

  • https://www.googleapis.com/auth/datamanager
UpdateUserListGlobalLicense

rpc UpdateUserListGlobalLicense(UpdateUserListGlobalLicenseRequest) returns (UserListGlobalLicense)

تعديل ترخيص عام لقائمة مستخدمين

لا تتوفّر هذه الميزة إلا لشركاء البيانات.

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

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

  • https://www.googleapis.com/auth/datamanager

UserListService

خدمة لإدارة موارد UserList.

CreateUserList

rpc CreateUserList(CreateUserListRequest) returns (UserList)

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

عناوين التفويض:

تتيح هذه الطريقة استخدام العناوين الاختيارية التالية لتحديد كيفية منح واجهة برمجة التطبيقات إذن الوصول إلى الطلب:

  • ‫login-account: (اختياري) اسم المورد للحساب الذي يكون فيه حساب Google الخاص ببيانات الاعتماد مستخدمًا. في حال عدم ضبط هذه القيمة، يتم تلقائيًا استخدام حساب الطلب. التنسيق: accountTypes/{loginAccountType}/accounts/{loginAccountId}
  • linked-account: (اختياري) اسم المرجع للحساب الذي تم ربطه بمنتج login-account. التنسيق: accountTypes/{linkedAccountType}/accounts/{linkedAccountId}
نطاقات الأذونات

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

  • https://www.googleapis.com/auth/datamanager
DeleteUserList

rpc DeleteUserList(DeleteUserListRequest) returns (Empty)

تحذف هذه الطريقة قائمة مستخدمين.

عناوين التفويض:

تتيح هذه الطريقة استخدام العناوين الاختيارية التالية لتحديد كيفية منح واجهة برمجة التطبيقات إذن الوصول إلى الطلب:

  • ‫login-account: (اختياري) اسم المورد للحساب الذي يكون فيه حساب Google الخاص ببيانات الاعتماد مستخدمًا. في حال عدم ضبط هذه القيمة، يتم تلقائيًا استخدام حساب الطلب. التنسيق: accountTypes/{loginAccountType}/accounts/{loginAccountId}
  • linked-account: (اختياري) اسم المرجع للحساب الذي تم ربطه بمنتج login-account. التنسيق: accountTypes/{linkedAccountType}/accounts/{linkedAccountId}
نطاقات الأذونات

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

  • https://www.googleapis.com/auth/datamanager
GetUserList

rpc GetUserList(GetUserListRequest) returns (UserList)

تعرض هذه الطريقة UserList.

عناوين التفويض:

تتيح هذه الطريقة استخدام العناوين الاختيارية التالية لتحديد كيفية منح واجهة برمجة التطبيقات إذن الوصول إلى الطلب:

  • ‫login-account: (اختياري) اسم المورد للحساب الذي يكون فيه حساب Google الخاص ببيانات الاعتماد مستخدمًا. في حال عدم ضبط هذه القيمة، يتم تلقائيًا استخدام حساب الطلب. التنسيق: accountTypes/{loginAccountType}/accounts/{loginAccountId}
  • linked-account: (اختياري) اسم المرجع للحساب الذي تم ربطه بمنتج login-account. التنسيق: accountTypes/{linkedAccountType}/accounts/{linkedAccountId}
نطاقات الأذونات

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

  • https://www.googleapis.com/auth/datamanager
ListUserLists

rpc ListUserLists(ListUserListsRequest) returns (ListUserListsResponse)

تعرض هذه الطريقة قوائم المستخدمين.

عناوين التفويض:

تتيح هذه الطريقة استخدام العناوين الاختيارية التالية لتحديد كيفية منح واجهة برمجة التطبيقات إذن الوصول إلى الطلب:

  • ‫login-account: (اختياري) اسم المورد للحساب الذي يكون فيه حساب Google الخاص ببيانات الاعتماد مستخدمًا. في حال عدم ضبط هذه القيمة، يتم تلقائيًا استخدام حساب الطلب. التنسيق: accountTypes/{loginAccountType}/accounts/{loginAccountId}
  • linked-account: (اختياري) اسم المرجع للحساب الذي تم ربطه بمنتج login-account. التنسيق: accountTypes/{linkedAccountType}/accounts/{linkedAccountId}
نطاقات الأذونات

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

  • https://www.googleapis.com/auth/datamanager
UpdateUserList

rpc UpdateUserList(UpdateUserListRequest) returns (UserList)

تعدِّل هذه الطريقة UserList.

عناوين التفويض:

تتيح هذه الطريقة استخدام العناوين الاختيارية التالية لتحديد كيفية منح واجهة برمجة التطبيقات إذن الوصول إلى الطلب:

  • ‫login-account: (اختياري) اسم المورد للحساب الذي يكون فيه حساب Google الخاص ببيانات الاعتماد مستخدمًا. في حال عدم ضبط هذه القيمة، يتم تلقائيًا استخدام حساب الطلب. التنسيق: accountTypes/{loginAccountType}/accounts/{loginAccountId}
  • linked-account: (اختياري) اسم المرجع للحساب الذي تم ربطه بمنتج login-account. التنسيق: accountTypes/{linkedAccountType}/accounts/{linkedAccountId}
نطاقات الأذونات

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

  • https://www.googleapis.com/auth/datamanager

AdEvent

حدث إعلان

الحقول
advertiser_id

string

الحقل مطلوب. رقم تعريف المعلِن لحدث الإعلان.

يجب أن يتطابق هذا المعرّف مع المعرّف المُرسَل في عملية الربط.
event_type

EventType

الحقل مطلوب. تمثّل هذه السمة نوع الحدث.
timestamp

Timestamp

الحقل مطلوب. الوقت الذي وقع فيه الحدث
event_id

string

اختيارية: معرّف ينشئه المتصل ويديره ويحدّد هذا الحدث بشكل فريد.

مطلوب إذا كنت تريد إزالة تكرار أحداث الإعلانات المُدرَجة في طلبات متعدّدة. بخلاف ذلك، يكون هذا الحقل اختياريًا.
user_data

UserData

اختيارية: أجزاء متعدّدة من البيانات المقدَّمة من المستخدِم، وتمثّل المستخدِم المرتبط بالحدث.

يمكن تقديم عدة أمثلة على النوع نفسه من البيانات (مثل عنوان البريد الإلكتروني). كلّما زادت البيانات المقدَّمة، زاد احتمال العثور على تطابق.
device_info

DeviceInfo

الحقل مطلوب. معلومات يتم جمعها عن الجهاز المستخدَم عند وقوع حدث الإعلان.
ip_address

string

اختيارية: عنوان IP المستخدَم للقياس يجب أن تكون هذه القيمة مماثلة لقيمة DeviceInfo.ip_address. اتركها فارغة إذا كنت لا تريد مشاركة عنوان IP لأغراض القياس.
mobile_device_id

string

اختيارية: رقم تعريف الجهاز الذي تم عرض الإعلان عليه.
campaign_id

string

الحقل مطلوب. رقم تعريف الحملة المرتبطة.
campaign_name

string

الحقل مطلوب. اسم الحملة المرتبطة.
ad_group_id

string

اختيارية: رقم تعريف المجموعة الإعلانية المرتبطة.
ad_id

string

اختيارية: رقم تعريف الإعلان المرتبط ضمن المجموعة.
ad_height

int32

اختيارية: ارتفاع الإعلان بالبكسل
ad_width

int32

اختيارية: عرض الإعلان بالبكسل
region_code

string

اختيارية: تمثّل هذه السمة البلد والتقسيم الفرعي وفقًا لمعيار ISO 3166-2.
source

string

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

string

الحقل مطلوب. نوع الإعلان، وهو مشابه لنوع مصدر الزيارات في "إحصاءات Google".
attribution_hint

AttributionHint

اختيارية: حالة تحديد المصدر التي يفترضها الشريك لحدث الإعلان هذا

ويعمل ذلك كإشارة فقط إلى كيفية تحديد المصدر من قِبل الشريك، ولا يفرض نتيجة نهائية في التقارير النهائية.
viewability_info

ViewabilityInfo

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

حقل الربط event_subtype_oneof اختيارية: تصنيف إضافي حول نوع حدث الإعلان.

يتم قبول سلسلة أولية للتعامل مع القيم الأخرى غير التعدادات النقية. يُفضَّل استخدام التعداد إذا أمكن ذلك. يمكن أن يكون التعليق event_subtype_oneof إحدى القيم التالية فقط:
event_subtype

EventSubtype

قيمة التعداد للنوع الفرعي للحدث
event_subtype_string

string

قيمة السلسلة للنوع الفرعي للحدث

حقل الربط ad_type_oneof اختيارية: نوع الإعلان المعروض

يتم قبول سلسلة أولية للتعامل مع القيم الأخرى غير التعدادات النقية. يُفضَّل استخدام التعداد إذا أمكن ذلك. يمكن أن يكون التعليق ad_type_oneof إحدى القيم التالية فقط:
ad_type

AdType

قيمة التعداد لنوع الإعلان.
ad_type_string

string

قيمة السلسلة لنوع الإعلان.

حقل الربط ad_format_oneof اختيارية: نوع الإعلان المعروض

يتم قبول سلسلة أولية للتعامل مع القيم الأخرى غير التعدادات النقية. يُفضَّل استخدام التعداد إذا أمكن ذلك. يمكن أن يكون التعليق ad_format_oneof إحدى القيم التالية فقط:
ad_format

AdFormat

قيمة التعداد لشكل الإعلان.
ad_format_string

string

قيمة السلسلة لشكل الإعلان.

حقل الربط ad_placement_oneof اختيارية: موضع الإعلان الذي تم عرضه

يتم قبول سلسلة أولية للتعامل مع القيم الأخرى غير التعدادات النقية. يُفضَّل استخدام التعداد إذا أمكن ذلك. يمكن أن يكون التعليق ad_placement_oneof إحدى القيم التالية فقط:
ad_placement

AdPlacement

قيمة التعداد لموضع الإعلان
ad_placement_string

string

قيمة السلسلة لموضع الإعلان

حقل الربط targeting_type_oneof اختيارية: نوع الاستهداف المستخدَم لعرض الإعلان.

يتم قبول سلسلة أولية للتعامل مع القيم الأخرى غير التعدادات النقية. يُفضَّل استخدام التعداد إذا أمكن ذلك. يمكن أن يكون التعليق targeting_type_oneof إحدى القيم التالية فقط:
targeting_type

TargetingType

قيمة التعداد لنوع الاستهداف.
targeting_type_string

string

قيمة السلسلة لنوع الاستهداف.

حقل الربط platform_type_oneof اختيارية: نوع المنصة التي تم عرض الإعلان عليها.

يتم قبول سلسلة أولية للتعامل مع القيم الأخرى غير التعدادات النقية. يُفضَّل استخدام التعداد إذا أمكن ذلك. يمكن أن يكون التعليق platform_type_oneof إحدى القيم التالية فقط:
platform_type

PlatformType

قيمة التعداد لنوع المنصة
platform_type_string

string

قيمة السلسلة لنوع النظام الأساسي

حقل الربط platform_oneof اختيارية: تفاصيل إضافية عن المنصة التي تم عرض الإعلان عليها

يتم قبول سلسلة أولية للتعامل مع القيم الأخرى غير التعدادات النقية. يُفضَّل استخدام التعداد إذا أمكن ذلك. يمكن أن يكون التعليق platform_oneof إحدى القيم التالية فقط:
platform

Platform

قيمة التعداد للمنصة
platform_string

string

قيمة السلسلة للنظام الأساسي
measurement_allowed

bool

اختيارية: توضّح هذه السمة ما إذا كان يُسمح باستخدام الصف لأغراض القياس، وذلك وفقًا لقوانين الخصوصية السارية ضمن الاختصاص الإقليمي.

EventSubtype

تصنيف إضافي حول نوع حدث الإعلان.

عمليات التعداد
EVENT_SUBTYPE_UNSPECIFIED نوع فرعي غير محدّد للحدث
EVENT_SUBTYPE_IMPRESSION حدث ظهور الإعلان
EVENT_SUBTYPE_ENGAGED_VIEW حدث المشاهدة المطوّلة
EVENT_SUBTYPE_ONSITE_CLICK حدث ناتج عن النقر على الموقع الإلكتروني
EVENT_SUBTYPE_OUTBOUND_CLICK حدث ناتج عن نقرة تؤدي إلى خارج النطاق

EventType

تمثّل هذه السمة نوع الحدث.

عمليات التعداد
EVENT_TYPE_UNSPECIFIED نوع حدث غير محدَّد.
EVENT_TYPE_VIEW عرض الحدث
EVENT_TYPE_CLICK حدث ناتج عن النقر.

AdFormat

تمثّل هذه السمة شكل الإعلان الذي تم عرضه.

عمليات التعداد
AD_FORMAT_UNSPECIFIED شكل الإعلان غير محدّد.
AD_FORMAT_AR إعلان الواقع المعزّز
AD_FORMAT_AUDIO إعلان صوتي
AD_FORMAT_BANNER إعلان بانر
AD_FORMAT_BUMPER إعلان ملصق صغير
AD_FORMAT_COLLECTION إعلان المجموعة
AD_FORMAT_IMAGE إعلان صوريّ.
AD_FORMAT_INTERACTIVE إعلان تفاعلي
AD_FORMAT_INTERSTITIAL إعلان بيني
AD_FORMAT_IN_FEED إعلان ضمن الخلاصة
AD_FORMAT_IN_STREAM إعلان أثناء عرض الفيديو
AD_FORMAT_IN_STREAM_SKIPPABLE إعلان قابل للتخطّي أثناء عرض الفيديو
AD_FORMAT_IN_STREAM_NON_SKIPPABLE إعلان غير قابل للتخطّي أثناء عرض الفيديو
AD_FORMAT_NATIVE إعلان مدمج مع المحتوى
AD_FORMAT_SHORTS إعلان على Shorts
AD_FORMAT_STORY إعلان على شكل قصة
AD_FORMAT_SPONSORED إعلان دعائي
AD_FORMAT_VIDEO إعلان فيديو.

AdIdentifiers

المعرّفات والمعلومات الأخرى المستخدَمة لمطابقة حدث الإحالة الناجحة مع النشاط الآخر على الإنترنت (مثل النقرات على الإعلانات)

الحقول
session_attributes

string

اختيارية: سمات الجلسة لتحديد مصدر الأحداث ووضع نماذج لها
gclid

string

اختيارية: معرّف النقرة من Google ‏ (gclid) المرتبط بهذا الحدث.
gbraid

string

اختيارية: معرّف النقرة للنقرات المرتبطة بأحداث التطبيق والتي تأتي من أجهزة iOS بدءًا من الإصدار 14 من نظام التشغيل iOS
wbraid

string

اختيارية: معرّف النقرة للنقرات المرتبطة بأحداث الموقع الإلكتروني والتي تأتي من أجهزة iOS بدءًا من الإصدار 14 من نظام التشغيل iOS
landing_page_device_info

DeviceInfo

اختيارية: المعلومات التي يتم جمعها عن الجهاز المستخدَم (إن وُجد) عند الوصول إلى الموقع الإلكتروني للمعلِن بعد التفاعل مع الإعلان
mobile_device_id

string

اختيارية: معرِّف إعلاني على الأجهزة الجوّالة سيكون هذا المعرّف هو معرّف المعلِنين (IDFA) على iOS أو المعرّف الإعلاني (AdID) على Android أو معرّفات المعلِنين على المنصات الأخرى.
dclid

string

اختيارية: معرّف النقرة على الإعلان الصوري المرتبط بهذا الحدث.
impression_id

string

اختيارية: تمثّل هذه السمة رقم تعريف مرّة الظهور المرتبط بهذا الحدث.
match_id

string

اختيارية: حقل رقم تعريف المطابقة المستخدَم لربط هذا الحدث بحدث سابق
encrypted_user_ids[]

EncryptedUserId

اختيارية: أي عدد من أرقام تعريف المستخدمين المشفرة
ppid

string

اختيارية: معرّف فريد لمستخدِم مصادَق عليه (تم تسجيل الدخول إليه)، كما يحدّده الناشر.
visitor_ppid

string

اختيارية: معرّف فريد لمستخدِم لم تتم مصادقته (مستخدِم لم يسجّل الدخول)، كما يحدّده الناشر.

AdPlacement

موضع الإعلان الذي تم عرضه

عمليات التعداد
AD_PLACEMENT_UNSPECIFIED موضع الإعلان غير محدّد
AD_PLACEMENT_DISCOVER موضع الإعلان على "اكتشف"
AD_PLACEMENT_FEED موضع الخلاصة
AD_PLACEMENT_HEADER موضع العنوان
AD_PLACEMENT_HOME موضع الإعلان على الصفحة الرئيسية
AD_PLACEMENT_IN_CONTENT موضع الإعلان داخل المحتوى
AD_PLACEMENT_PROMOTED موضع إعلان مدفوع:
AD_PLACEMENT_STORY موضع القصة

AdType

نوع الإعلان المعروض

عمليات التعداد
AD_TYPE_UNSPECIFIED نوع الإعلان غير محدَّد.
AD_TYPE_DISPLAY إعلان صوري
AD_TYPE_TEXT إعلان نصي.
AD_TYPE_IMAGE إعلان صوريّ.
AD_TYPE_RICH_MEDIA إعلان وسائط تفاعلية متقدّمة
AD_TYPE_HTML إعلان HTML
AD_TYPE_AUDIO إعلان صوتي
AD_TYPE_VIDEO إعلان فيديو.

AddressInfo

معلومات العنوان الخاصة بالمستخدم

الحقول
given_name

string

الحقل مطلوب. الاسم (الأول) للمستخدم، بأحرف صغيرة فقط، بدون علامات ترقيم، وبدون مسافات بيضاء في البداية أو النهاية، ومجزّأ باستخدام خوارزمية SHA-256
family_name

string

الحقل مطلوب. اسم العائلة للمستخدم، بأحرف صغيرة فقط، بدون علامات ترقيم، وبدون مسافات بيضاء في البداية أو النهاية، ومجزّأ باستخدام خوارزمية SHA-256
region_code

string

الحقل مطلوب. يشير ذلك إلى رمز المنطقة المكوّن من حرفَين حسب المعيار ISO-3166-1 alpha-2 الخاص بعنوان المستخدِم.
postal_code

string

الحقل مطلوب. الرمز البريدي لعنوان المستخدم
address_line

string

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

تسوية القيمة قبل التجزئة:

  • إزالة رموز الأحرف
  • تحويل النص إلى أحرف لاتينية صغيرة
  • إزالة المسافات البيضاء البادئة واللاحقة
city

string

اختيارية: مدينة عنوان المستخدم تُستخدَم فقط لخدمة "إحصاءات Google".

يجب تسوية القيمة على النحو التالي:

  • إزالة رموز الأحرف
  • تحويل النص إلى أحرف لاتينية صغيرة
  • إزالة المسافات البيضاء البادئة واللاحقة
administrative_area

string

اختيارية: المنطقة الإدارية (الولاية أو المقاطعة) لعنوان المستخدم تُستخدَم فقط لخدمة "إحصاءات Google".

يجب تسوية القيمة على النحو التالي:

  • إزالة رموز الأحرف
  • تحويل النص إلى أحرف لاتينية صغيرة
  • إزالة المسافات البيضاء البادئة واللاحقة

معدل العمر

الفئات العمرية الديمغرافية

عمليات التعداد
AGE_RANGE_UNSPECIFIED لم يتم تحديد أي قيمة.
AGE_RANGE_UNKNOWN غير معروف.
AGE_RANGE_18_24 أن تتراوح أعمارهم بين 18 و24 عامًا
AGE_RANGE_25_34 تتراوح أعمارهم بين 25 و34 عامًا.
AGE_RANGE_35_44 تتراوح أعمارهم بين 35 و44 عامًا
AGE_RANGE_45_54 تتراوح أعمارهم بين 45 و54 عامًا.
AGE_RANGE_55_64 تتراوح أعمارهم بين 55 و64 عامًا
AGE_RANGE_65_UP 65 عامًا وما فوق

AttributionHint

حالة تحديد المصدر التي يفترضها الشريك لحدث الإعلان هذا

عمليات التعداد
ATTRIBUTION_HINT_UNSPECIFIED حالة تحديد المصدر غير معروفة.
ATTRIBUTION_HINT_CONVERTED الحالة التي تم تحويلها
ATTRIBUTION_HINT_NOT_CONVERTED الحالة "لم يتمّ التحويل"

AudienceMember

عضو الجمهور الذي سيتم إجراء العملية الجراحية له

الحقول
destination_references[]

string

اختيارية: تحدّد هذه السمة Destination التي سيتم توجيه عضو في الجمهور إليها.
consent

Consent

اختيارية: إعداد الموافقة للمستخدم
حقل الربط data تمثّل هذه السمة نوع البيانات التعريفية المطلوب إجراء عملية عليها. يمكن أن يكون التعليق data إحدى القيم التالية فقط:
user_data

UserData

البيانات المقدَّمة من المستخدم والتي تحدّد هويته
pair_data

PairData

معرّفات Publisher Advertiser Identity Reconciliation (PAIR)

لا تتوفّر هذه الميزة إلا لشركاء البيانات.
mobile_data

MobileData

تشير هذه السمة إلى البيانات التي تحدّد الأجهزة الجوّالة للمستخدم.
user_id_data

UserIdData

بيانات مرتبطة بمعرّفات فريدة لمستخدِم، كما يحدّدها المعلِن
ppid_data

PpidData

البيانات المتعلّقة بالمعرّفات المقدَّمة من الناشر

لا تتوفّر هذه الميزة إلا لشركاء البيانات.
composite_data

CompositeData

مجموعة من أنواع المعرّفات المتعددة
google_user_id_data

GoogleUserIdData

أرقام تعريف مستخدمي Google المشفّرة
partner_provided_id_data

PartnerProvidedIdData

المعرّفات المقدَّمة من الشريك

AwsWrappedKeyInfo

مفتاح تشفير البيانات الذي يتم تغليفه بمفتاح AWS KMS

الحقول
key_type

KeyType

الحقل مطلوب. نوع الخوارزمية المستخدَمة لتشفير البيانات
role_arn

string

الحقل مطلوب. اسم مورد Amazon لدور "إدارة الهوية وإمكانية الوصول" (IAM) الذي يجب افتراضه للوصول إلى فك التشفير في KMS يجب أن يكون بالتنسيق arn:{partition}:iam::{account_id}:role/{role_name}
kek_uri

string

الحقل مطلوب. معرّف الموارد المنتظم (URI) لمفتاح AWS KMS المستخدَم لفك تشفير مفتاح تشفير البيانات. يجب أن يكون بالتنسيق arn:{partition}:kms:{region}:{account_id}:key/{key_id} أو aws-kms://arn:{partition}:kms:{region}:{account_id}:key/{key_id}
encrypted_dek

string

الحقل مطلوب. مفتاح تشفير البيانات المشفّر المرمّز باستخدام Base64

KeyType

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

عمليات التعداد
KEY_TYPE_UNSPECIFIED نوع المفتاح غير محدَّد. يجب عدم استخدامها مطلقًا.
XCHACHA20_POLY1305 الخوارزمية XChaCha20-Poly1305

Baseline

المعايير الأساسية التي تتم مقارنة الإحصاءات بها

الحقول
حقل الربط baseline الموقع الجغرافي الأساسي الذي تتم مقارنة الإحصاءات به يمكن أن يكون التعليق baseline إحدى القيم التالية فقط:
baseline_location

Location

الموقع الجغرافي الأساسي للطلب الموقع الجغرافي الأساسي هو قائمة "أو" للمناطق المطلوبة.
location_auto_detection_enabled

bool

في حال ضبطها على "صحيح"، ستحاول الخدمة رصد الموقع الجغرافي الأساسي للإحصاءات تلقائيًا.

الموقع الجغرافي

الموقع الجغرافي الأساسي للطلب يجب أن يكون الموقع الجغرافي الأساسي ضمن قائمة رموز المناطق ذات تنسيق ISO 3166-1 alpha-2 المطلوبة.

الحقول
region_codes[]

string

قائمة برموز المناطق وفقًا لمعيار ISO 3166-1 alpha-2

CartData

بيانات سلة التسوّق المرتبطة بالحدث

الحقول
merchant_id

string

اختيارية: معرّف Merchant Center المرتبط بالسلع.
merchant_feed_label

string

اختيارية: تصنيف الخلاصة في Merchant Center المرتبط بخلاصة السلع
merchant_feed_language_code

string

اختيارية: رمز اللغة في معيار ISO 639-1 المرتبط بخلاصة Merchant Center الخاصة بالسلع التي يتم تحميلها.
transaction_discount

double

اختيارية: مجموع كل الخصومات المرتبطة بالمعاملة.
items[]

Item

اختيارية: قائمة السلع المرتبطة بالحدث
coupon_codes[]

string

اختيارية: قائمة رموز القسائم التي تم تطبيقها على سلّة التسوّق. تكون رموز القسائم على مستوى سلة التسوق وعلى مستوى السلعة مستقلة عن بعضها.

إذا كان الحدث مخصّصًا لوجهة "إحصاءات Google"، قدِّم رمز قسيمة واحدًا فقط. تتجاهل "إحصاءات Google" رموز القسائم الإضافية.

CompositeData

بيانات مركّبة تحتوي على معرّفات وبيانات مرتبطة بمستخدم. يجب توفير سمة واحدة على الأقل من user_data أو ip_data.

الحقول
user_data

UserData

اختيارية: البيانات المقدَّمة من المستخدم والتي تحدّد هويته
ip_data[]

IpData

اختيارية: بيانات عناوين IP التي تمثّل تفاعل العملاء والمستخدَمة لإنشاء شريحة الجمهور

إعدادات الموافقة بموجب قانون الأسواق الرقمية (DMA) للمستخدم

الحقول
ad_user_data

ConsentStatus

اختيارية: تمثّل ما إذا كان المستخدم يوافق على بيانات مستخدمي الإعلانات.
ad_personalization

ConsentStatus

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

ConsentStatus

تمثّل هذه السمة ما إذا كان المستخدِم قد منح الموافقة أو رفضها أو لم يحدّدها.

عمليات التعداد
CONSENT_STATUS_UNSPECIFIED لم يتم تحديد أي قيمة.
CONSENT_GRANTED تم منح الموافقة.
CONSENT_DENIED تم الرفض.

ContactIdInfo

معلومات إضافية عندما يكون CONTACT_ID أحد upload_key_types

الحقول
match_rate_percentage

int32

النتائج فقط. نسبة المطابقة لقوائم مستخدمي ميزة "مطابقة العملاء"
data_source_type

DataSourceType

اختيارية: غير قابل للتغيير. مصدر بيانات التحميل

CoordinatorKeyInfo

معلومات حول مفتاح المنسّق

الحقول
key_id

string

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

CreatePartnerLinkRequest

طلب إنشاء مورد PartnerLink تعرض PartnerLink.

يمكنك تجربة هذه الطريقة في مستكشف واجهات REST API:
تجربة REST
الحقول
parent

string

الحقل مطلوب. العنصر الرئيسي الذي يملك هذه المجموعة من روابط الشركاء التنسيق: accountTypes/{account_type}/accounts/{account}

CreateUserListDirectLicenseRequest

طلب إنشاء مورد UserListDirectLicense

يمكنك تجربة هذه الطريقة في مستكشف واجهات REST API:
تجربة REST
الحقول
parent

string

الحقل مطلوب. الحساب الذي يملك قائمة المستخدمين المرخَّصة. يجب أن يكون بالتنسيق accountTypes/{ACCOUNT_TYPE}/accounts/{ACCOUNT_ID}
user_list_direct_license

UserListDirectLicense

الحقل مطلوب. قائمة المستخدمين التي لديها ترخيص مباشر لإنشاء حساب

CreateUserListGlobalLicenseRequest

طلب إنشاء مورد UserListGlobalLicense

يمكنك تجربة هذه الطريقة في مستكشف واجهات REST API:
تجربة REST
الحقول
parent

string

الحقل مطلوب. الحساب الذي يملك قائمة المستخدمين المرخَّصة. يجب أن يكون بالتنسيق accountTypes/{ACCOUNT_TYPE}/accounts/{ACCOUNT_ID}
user_list_global_license

UserListGlobalLicense

الحقل مطلوب. الترخيص العام لإنشاء قائمة المستخدمين

CreateUserListRequest

طلب الرسالة لـ CreateUserList

يمكنك تجربة هذه الطريقة في مستكشف واجهات REST API:
تجربة REST
الحقول
parent

string

الحقل مطلوب. حساب الأب الذي سيتم إنشاء قائمة المستخدمين هذه فيه. التنسيق: accountTypes/{account_type}/accounts/{account}
user_list

UserList

الحقل مطلوب. قائمة المستخدمين المطلوب إنشاؤها.
validate_only

bool

اختيارية: إذا كانت القيمة صحيحة، يتم التحقّق من صحة الطلب ولكن لا يتم تنفيذه.

المتغيّر المخصّص

متغيّر مخصّص للإحالات الناجحة من الإعلانات

الحقول
variable

string

اختيارية: اسم المتغيّر المخصّص الذي سيتم ضبطه. إذا لم يتم العثور على المتغيّر للوجهة المحدّدة، سيتم تجاهله.
value

string

اختيارية: القيمة المطلوب تخزينها للمتغيّر المخصّص.
destination_references[]

string

اختيارية: سلسلة مرجعية تُستخدَم لتحديد Event.destination_references الذي يجب إرسال المتغيّر المخصّص إليه. في حال تركها فارغة، سيتم استخدام Event.destination_references.

CustomerType

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

عمليات التعداد
CUSTOMER_TYPE_UNSPECIFIED Unspecified CustomerType. يجب عدم استخدامها مطلقًا.
NEW العميل جديد بالنسبة إلى المعلِن.
RETURNING يعود العميل إلى المعلِن.
REENGAGED تفاعل العميل مجددًا مع المعلِن.

CustomerValueBucket

القيمة التي يحدّدها المعلِن للعميل.

عمليات التعداد
CUSTOMER_VALUE_BUCKET_UNSPECIFIED Unspecified CustomerValueBucket. يجب عدم استخدامها مطلقًا.
LOW العميل ذو قيمة منخفضة.
MEDIUM العميل ذو قيمة متوسطة.
HIGH العميل قيّم.

DataSourceType

تشير هذه السمة إلى مصدر بيانات التحميل.

عمليات التعداد
DATA_SOURCE_TYPE_UNSPECIFIED لم يتم تحديد أي قيمة.
DATA_SOURCE_TYPE_FIRST_PARTY البيانات التي تم تحميلها هي بيانات الطرف الأول.
DATA_SOURCE_TYPE_THIRD_PARTY_CREDIT_BUREAU البيانات التي تم تحميلها هي من مكتب ائتمان تابع لجهة خارجية.
DATA_SOURCE_TYPE_THIRD_PARTY_VOTER_FILE البيانات التي تم تحميلها مأخوذة من ملف ناخبين تابع لجهة خارجية.
DATA_SOURCE_TYPE_THIRD_PARTY_PARTNER_DATA البيانات التي تم تحميلها هي بيانات شريك خارجي.

DeletePartnerLinkRequest

طلب حذف مورد PartnerLink تعرض google.protobuf.Empty.

يمكنك تجربة هذه الطريقة في مستكشف REST API:
تجربة REST
الحقول
name

string

الحقل مطلوب. اسم المورد الخاص برابط الشريك المطلوب حذفه. التنسيق: accountTypes/{account_type}/accounts/{account}/partnerLinks/{partner_link}

DeleteUserListRequest

رسالة الطلب الخاصة بوظيفة DeleteUserList

يمكنك تجربة هذه الطريقة في مستكشف واجهات REST API:
تجربة REST
الحقول
name

string

الحقل مطلوب. اسم قائمة المستخدِمين المطلوب حذفها. التنسيق: accountTypes/{account_type}/accounts/{account}/userLists/{user_list}
validate_only

bool

اختيارية: إذا كانت القيمة صحيحة، يتم التحقّق من صحة الطلب ولكن لا يتم تنفيذه.

الوجهة

منتج Google الذي يتم إرسال البيانات إليه على سبيل المثال، حساب على "إعلانات Google".

الحقول
reference

string

اختيارية: معرّف مورد Destination هذا، وهو معرّف فريد ضمن الطلب. يُستخدَم للإشارة إلى Destination هذا في IngestEventsRequest وIngestAudienceMembersRequest.
login_account

ProductAccount

اختيارية: الحساب المستخدَم لإجراء طلب البيانات من واجهة برمجة التطبيقات هذا لإضافة بيانات إلى operating_account أو إزالتها منه، يجب أن يكون لدى login_account إذن كتابة للوصول إلى operating_account. على سبيل المثال، حساب إداري تابع لـ operating_account، أو حساب مرتبط بـ operating_account.
linked_account

ProductAccount

اختيارية: حساب يمكن أن يصل إليه login_account للمستخدم الذي يجري الاتصال، وذلك من خلال رابط حساب تم إنشاؤه. على سبيل المثال، قد يكون لدى login_account أحد شركاء البيانات إذن الوصول إلى linked_account أحد العملاء. قد يستخدم الشريك هذا الحقل لإرسال البيانات من linked_account إلى operating_account آخر.
operating_account

ProductAccount

الحقل مطلوب. الحساب الذي سيتم إرسال البيانات إليه أو إزالتها منه
product_destination_id

string

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

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

DeviceInfo

معلومات عن الجهاز المستخدَم (إن وُجد) عند وقوع الحدث

الحقول
user_agent

string

اختيارية: سلسلة وكيل المستخدم للجهاز في السياق المحدّد
ip_address

string

اختيارية: عنوان IP للجهاز في السياق المحدّد مطلوبة عند استخدامها في AdEvent لإجراء عمليات التحقّق الجغرافي.
category

string

اختيارية: فئة الجهاز على سبيل المثال، "كمبيوتر مكتبي" أو "جهاز لوحي" أو "جهاز جوّال" أو "تلفزيون ذكي".
language_code

string

اختيارية: اللغة التي يستخدمها الجهاز بتنسيق ISO 639-1
screen_height

int32

اختيارية: تمثّل هذه السمة ارتفاع الشاشة بالبكسل.
screen_width

int32

اختيارية: تمثّل هذه السمة عرض الشاشة بالبكسل.
operating_system

string

اختيارية: نظام التشغيل أو النظام الأساسي للجهاز
operating_system_version

string

اختيارية: إصدار نظام التشغيل أو النظام الأساسي
model

string

اختيارية: طراز الجهاز
brand

string

اختيارية: تمثّل هذه السمة العلامة التجارية للجهاز.
browser

string

اختيارية: تمثّل هذه السمة العلامة التجارية للمتصفّح أو نوعه.
browser_version

string

اختيارية: إصدار المتصفّح

الترميز

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

عمليات التعداد
ENCODING_UNSPECIFIED نوع الترميز غير محدَّد. يجب عدم استخدامها مطلقًا.
HEX الترميز السداسي العشري
BASE64 ترميز Base 64

EncryptedUserId

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

الحقول
encrypted_id

string

الحقل مطلوب. المعرّف المشفّر الأبجدي الرقمي
entity_type

EncryptionEntityType

الحقل مطلوب. نوع كيان التشفير. يجب أن يتطابق ذلك مع إعدادات التشفير لعرض الإعلانات أو "نقل البيانات".
entity_id

int64

الحقل مطلوب. معرّف كيان التشفير يجب أن يتطابق ذلك مع إعدادات التشفير لعرض الإعلانات أو "نقل البيانات".
source

EncryptionSource

الحقل مطلوب. توضّح هذه السمة ما إذا تم تلقّي ملف تعريف الارتباط المشفّر من عرض الإعلانات (وحدة الماكرو %m) أو من "نقل البيانات".

EncryptionEntityType

نوع كيان التشفير.

عمليات التعداد
ENCRYPTION_ENTITY_TYPE_UNSPECIFIED نوع كيان التشفير غير محدّد.
CAMPAIGN_MANAGER_ACCOUNT حساب على "مدير الحملة 360"
CAMPAIGN_MANAGER_ADVERTISER معلِن في "مدير الحملة 360"
DISPLAY_VIDEO_PARTNER شريك "مساحة العرض والفيديو 360"
DISPLAY_VIDEO_ADVERTISER مُعلِن على "مساحة العرض والفيديو 360"
GOOGLE_ADS_CUSTOMER عميل "إعلانات Google"
GOOGLE_AD_MANAGER_NETWORK_CODE معرِّف شبكة "إدارة إعلانات Google"

EncryptionSource

مصدر التشفير

عمليات التعداد
ENCRYPTION_SOURCE_UNSPECIFIED مصدر التشفير غير محدّد.
AD_SERVING مصدر تشفير عرض الإعلانات
DATA_TRANSFER مصدر تشفير نقل البيانات

EncryptionInfo

معلومات التشفير للبيانات التي يتم نقلها

الحقول
حقل الربط wrapped_key المفتاح المغلف المستخدَم لتشفير البيانات يمكن أن يكون التعليق wrapped_key إحدى القيم التالية فقط:
gcp_wrapped_key_info

GcpWrappedKeyInfo

معلومات المفتاح المغلف في Google Cloud Platform
aws_wrapped_key_info

AwsWrappedKeyInfo

معلومات مفتاح التشفير المغلف في Amazon Web Services
coordinator_key_info

CoordinatorKeyInfo

معلومات أساسية عن مفتاح المنسّق المحدّد

لا تتوفّر هذه الميزة لطُرق الدفع IngestEvents وIngestAudienceMembers وRemoveAudienceMembers.

ErrorCount

عدد الأخطاء لسبب خطأ معيّن

الحقول
record_count

int64

عدد السجلات التي تعذّر تحميلها لسبب معيّن
reason

ProcessingErrorReason

سبب الخطأ في السجلات التي تعذّر تنفيذها.

ErrorInfo

عدد الأخطاء لكل نوع من أنواع الأخطاء

الحقول
error_counts[]

ErrorCount

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

ErrorReason

أسباب الخطأ في Data Manager API ملاحظة: هذه القائمة غير ثابتة وقد تتم إضافة قيم جديدة إليها في المستقبل.

عمليات التعداد
ERROR_REASON_UNSPECIFIED لا تستخدِم هذه القيمة التلقائية.
INTERNAL_ERROR حدث خطأ داخلي.
DEADLINE_EXCEEDED استغرق الطلب وقتًا طويلاً للردّ.
RESOURCE_EXHAUSTED عدد الطلبات كبير جدًا.
NOT_FOUND لم يتم العثور على المورد.
PERMISSION_DENIED لا يملك المستخدم الإذن اللازم أو لم يتم العثور على المرجع.
INVALID_ARGUMENT حدثت مشكلة في الطلب.
REQUIRED_FIELD_MISSING لم يتم إدخال حقل مطلوب.
INVALID_FORMAT التنسيق غير صالح.
INVALID_HEX_ENCODING لم يتم تكوين القيمة المشفرة بنظام HEX بشكل صحيح.
INVALID_BASE64_ENCODING لم يتم تكوين القيمة المرمّزة باستخدام base64 بشكل صحيح.
INVALID_SHA256_FORMAT لم يتم تكوين القيمة المشفرة بخوارزمية SHA256 بشكل صحيح.
INVALID_POSTAL_CODE الرمز البريدي غير صالح.
INVALID_COUNTRY_CODE

تم إيقافها نهائيًا: لا يتم استخدام التعداد في Data Manager API.
INVALID_ENUM_VALUE لا يمكن استخدام قيمة التعداد.
INVALID_USER_LIST_TYPE لا ينطبق نوع قائمة المستخدمين على هذا الطلب.
INVALID_AUDIENCE_MEMBER عضو الجمهور هذا غير صالح.
TOO_MANY_AUDIENCE_MEMBERS الحدّ الأقصى لعدد أفراد الجمهور المسموح به لكل طلب هو 10,000.
TOO_MANY_USER_IDENTIFIERS الحد الأقصى لعدد معرّفات المستخدمين المسموح بها لكل عضو في الجمهور هو 10.
TOO_MANY_DESTINATIONS الحدّ الأقصى لعدد الوجهات المسموح بها لكل طلب هو 10.
INVALID_DESTINATION هذه الوجهة غير صالحة.
DATA_PARTNER_USER_LIST_MUTATE_NOT_ALLOWED لا يمكن لشريك البيانات الوصول إلى قائمة مستخدمي الحساب التشغيلي.
INVALID_MOBILE_ID_FORMAT تنسيق رقم تعريف الجهاز الجوّال غير صالح.
INVALID_USER_LIST_ID قائمة المستخدمين غير صالحة.
MULTIPLE_DATA_TYPES_NOT_ALLOWED لا يُسمح بإدخال أنواع بيانات متعددة في طلب واحد.
DIFFERENT_LOGIN_ACCOUNTS_NOT_ALLOWED_FOR_DATA_PARTNER يجب أن تتضمّن إعدادات الوجهة التي تحتوي على حساب تسجيل دخول DataPartner حساب تسجيل الدخول نفسه في جميع إعدادات الوجهة.
TERMS_AND_CONDITIONS_NOT_SIGNED لم يتم قبول الأحكام والشروط المطلوبة.
INVALID_NUMBER_FORMAT تنسيق الرقم غير صالح.
INVALID_CONVERSION_ACTION_ID رقم تعريف إجراء الإحالة الناجحة غير صالح.
INVALID_CONVERSION_ACTION_TYPE نوع إجراء الإحالة الناجحة غير صالح.
INVALID_CURRENCY_CODE رمز العملة غير متاح.
INVALID_EVENT هذا الحدث غير صالح.
TOO_MANY_EVENTS الحدّ الأقصى لعدد الأحداث المسموح بها لكلّ طلب هو 10,000 حدث.
DESTINATION_ACCOUNT_NOT_ENABLED_ENHANCED_CONVERSIONS_FOR_LEADS لم يتم تفعيل ميزة "الإحالات الناجحة المحسّنة للعملاء المحتملين" في حساب الوجهة.
DESTINATION_ACCOUNT_DATA_POLICY_PROHIBITS_ENHANCED_CONVERSIONS لا يمكن استخدام ميزة "الإحالات الناجحة المحسّنة" لحساب الوجهة بسبب سياسات بيانات العملاء في Google. يُرجى التواصل مع ممثل Google الذي تتعامل معه.
DESTINATION_ACCOUNT_ENHANCED_CONVERSIONS_TERMS_NOT_SIGNED لم يوافق الحساب الوجهة على بنود "الإحالات الناجحة المحسّنة".
DUPLICATE_DESTINATION_REFERENCE يتضمّن الطلب وجهتَين أو أكثر لهما المرجع نفسه.
UNSUPPORTED_OPERATING_ACCOUNT_FOR_DATA_PARTNER حساب تشغيلي غير متوافق لتفويض شريك البيانات
UNSUPPORTED_LINKED_ACCOUNT_FOR_DATA_PARTNER حساب مرتبط غير متوافق مع تفويض شريك البيانات.
NO_IDENTIFIERS_PROVIDED لا تحتوي بيانات الأحداث على معرّفات مستخدمين أو معرّفات إعلانات. بالنسبة إلى استيعاب أحداث Floodlight، يشير هذا الخطأ إلى أنّ الطلبات لا تحتوي على معرّفات إعلانات.
INVALID_PROPERTY_TYPE نوع الموقع غير متاح.
INVALID_STREAM_TYPE نوع البث غير متاح.
LINKED_ACCOUNT_ONLY_ALLOWED_WITH_DATA_PARTNER_LOGIN_ACCOUNT لا يمكن ربط الحساب إلا إذا كان حساب تسجيل الدخول هو حساب DATA_PARTNER.
OPERATING_ACCOUNT_LOGIN_ACCOUNT_MISMATCH يجب أن يكون حساب تسجيل الدخول هو نفسه حساب التشغيل لحالة الاستخدام المحدّدة.
EVENT_TIME_INVALID لم يحدث الحدث خلال الفترة الزمنية المقبولة.
RESERVED_NAME_USED تستخدِم المَعلمة اسمًا محجوزًا.
INVALID_EVENT_NAME اسم الحدث غير متوافق.
NOT_ALLOWLISTED الحساب غير مُدرَج في القائمة المسموح بها للميزة المحدّدة.
INVALID_REQUEST_ID رقم تعريف الطلب المستخدَم لاسترداد حالة الطلب غير صالح. لا يمكن استرداد الحالة إلا للطلبات التي تنجح ولا تحتوي على validate_only=true.
MULTIPLE_DESTINATIONS_FOR_GOOGLE_ANALYTICS_EVENT كان للحدث وجهتان أو أكثر في "إحصاءات Google".
FIELD_VALUE_TOO_LONG طول قيمة الحقل كبير جدًا.
FIELD_VALUE_TOO_SHORT طول قيمة الحقل قصير جدًا.
TOO_MANY_ELEMENTS عدد العناصر في القائمة في الطلب كبير جدًا.
TOO_FEW_ELEMENTS عدد العناصر في القائمة في الطلب قليل جدًا.
ALREADY_EXISTS المورد متوفّر حاليًا.
IMMUTABLE_FIELD_FOR_UPDATE تمت محاولة ضبط حقل غير قابل للتغيير لطلب تعديل.
INVALID_RESOURCE_NAME اسم المرجع غير صالح.
INVALID_FILTER فلتر طلب البحث غير صالح.
INVALID_UPDATE_MASK قناع التعديل غير صالح.
INVALID_PAGE_TOKEN الرمز المميز للصفحة غير صالح.
CANNOT_UPDATE_DISABLED_LICENSE لا يمكن تعديل ترخيص تم إيقافه.
CANNOT_CREATE_LICENSE_FOR_SENSITIVE_USERLIST لا يمكن ترخيص قوائم المستخدمين الحسّاسة لهذا العميل.
INSUFFICIENT_COST التكلفة منخفضة جدًا بالنسبة إلى هذا الترخيص.
CANNOT_DISABLE_LICENSE لا يمكن إيقاف ترخيص المورِّد لأنّه قيد الاستخدام.
INVALID_CLIENT_ACCOUNT_ID رقم تعريف حساب العميل غير صالح.
PRICING_ONLY_ZERO_COST_ALLOWED لا يُسمح بتكلفة غير صفرية لحساب العميل هذا.
PRICE_TOO_HIGH التكلفة مرتفعة جدًا بالنسبة إلى هذا الترخيص.
CUSTOMER_NOT_ALLOWED_TO_CREATE_LICENSE لا يُسمح للعميل بإنشاء ترخيص.
INVALID_PRICING_END_DATE تاريخ انتهاء السعر غير صالح لهذه الرخصة.
CANNOT_LICENSE_LOGICAL_LIST_WITH_LICENSED_OR_SHARED_SEGMENT لا يمكن ترخيص قائمة المستخدمين المنطقية التي تتضمّن شريحة مشترَكة أو مرخَّصة.
MISMATCHED_ACCOUNT_TYPE لا يتطابق نوع حساب العميل في الطلب مع نوع حساب العميل الفعلي.
MEDIA_SHARE_COST_NOT_ALLOWED_FOR_LICENSE_TYPE لا يتيح نوع الترخيص مشاركة تكلفة الوسائط.
MEDIA_SHARE_COST_NOT_ALLOWED_FOR_CLIENT_CUSTOMER لا يتيح نوع عميل العميل مشاركة تكلفة الوسائط.
INVALID_MEDIA_SHARE_COST تكلفة مشاركة الوسائط غير صالحة.
INVALID_COST_TYPE نوع التكلفة غير صالح.
MEDIA_SHARE_COST_NOT_ALLOWED_FOR_NON_COMMERCE_USER_LIST لا يتيح نوع UserList تكلفة مشاركة الوسائط.
MAX_COST_NOT_ALLOWED لا يُسمح باستخدام السمة "الحد الأقصى للتكلفة" إلا مع cost_type MEDIA_SHARE.
COMMERCE_AUDIENCE_CAN_ONLY_BE_DIRECTLY_LICENSED لا يمكن ترخيص شرائح جمهور التجارة إلا بشكل مباشر.
INVALID_DESCRIPTION الوصف غير صالح.
INVALID_DISPLAY_NAME الاسم المعروض غير صالح.
DISPLAY_NAME_ALREADY_USED الاسم المعروض مستخدَم حاليًا لقائمة مستخدمين أخرى في الحساب.
OWNERSHIP_REQUIRED_FOR_UPDATE يجب أن تكون مالكًا لتعديل قائمة المستخدمين.
USER_LIST_MUTATION_NOT_SUPPORTED نوع قائمة المستخدمين متاح للقراءة فقط ولا يتيح التعديل.
SENSITIVE_USER_LIST_IMMUTABLE لا يمكن للمستخدمين الخارجيين تعديل قائمة مستخدمين حساسة للخصوصية أو مرفوضة قانونيًا.
BILLABLE_RECORD_COUNT_IMMUTABLE لا يمكن تعديل حقل السجلّ القابل للفوترة في قائمة مستخدمي تجديد النشاط التسويقي بعد ضبطه.
USER_LIST_NAME_RESERVED اسم قائمة المستخدم محجوز لقوائم النظام.
ADVERTISER_NOT_ALLOWLISTED_FOR_UPLOADED_DATA يجب أن يكون المعلِن مدرَجًا في القائمة المسموح بها لاستخدام قوائم تجديد النشاط التسويقي التي تم إنشاؤها من البيانات التي حمّلها المعلِن.
UNSUPPORTED_PARTNER_AUDIENCE_SOURCE مصدر بيانات عن الجمهور الشريك غير متاح لنوع قائمة المستخدمين.
COMMERCE_PARTNER_NOT_ALLOWED لا يمكن ضبط الحقل commerce_partner إلا إذا كانت قيمة partner_audience_source هي COMMERCE_AUDIENCE.
UNSUPPORTED_PARTNER_AUDIENCE_INFO الحقل partner_audience_info غير متاح لنوع قائمة المستخدِمين.
PARTNER_MATCH_FOR_MANAGER_ACCOUNT_DISALLOWED لا يمكن للحسابات الإدارية إنشاء قوائم مستخدمي "مطابقة الشركاء".
DATA_PARTNER_NOT_ALLOWLISTED_FOR_THIRD_PARTY_PARTNER_DATA لم يتم إدراج شريك البيانات في القائمة المسموح بها لـ THIRD_PARTY_PARTNER_DATA.
ADVERTISER_TOS_NOT_ACCEPTED لم يقبل المعلِن بنود خدمة الشريك.
ADVERTISER_NOT_ALLOWLISTED_FOR_THIRD_PARTY_PARTNER_DATA المعلن غير مُدرَج في القائمة المسموح بها لاستخدام THIRD_PARTY_PARTNER_DATA.
USER_LIST_TYPE_NOT_SUPPORTED_FOR_ACCOUNT نوع قائمة المستخدمين هذا غير متاح لهذا الحساب.
INVALID_COMMERCE_PARTNER الحقل commerce_partner غير صالح.
CUSTOMER_NOT_ALLOWLISTED_FOR_COMMERCE_AUDIENCE لم تتم إضافة مزوّد البيانات إلى القائمة المسموح بها لإنشاء شرائح جمهور للتجارة.
UNSUPPORTED_USER_LIST_UPLOAD_KEY_TYPES أنواع مفاتيح تحميل قوائم المستخدمين غير متاحة.
UNSUPPORTED_INGESTED_USER_LIST_INFO_CONFIG إعدادات معلومات قائمة المستخدِمين التي تمّت إضافتها غير متاحة.
UNSUPPORTED_ACCOUNT_TYPES_FOR_USER_LIST_TYPE أنواع الحسابات غير متاحة لنوع قائمة المستخدِمين.
MEMBERSHIP_DURATION_TOO_LONG مدة عضوية قائمة المستخدمين طويلة جدًا.
INVALID_MERCHANT_ID الحقل merchant_id غير صالح.
EU_POLITICAL_ADVERTISING_DECLARATION_REQUIRED يحتوي حساب العميل على حملات غير معفاة من بيان الإعلانات السياسية عن الاتحاد الأوروبي.
ACCOUNT_INELIGIBLE_FOR_STORE_SALES الحساب غير مؤهَّل للاستفادة من ميزة "المبيعات في المتجر".
INVALID_MERCHANT_FEED_LANGUAGE_CODE رمز لغة خلاصة التاجر غير صالح.
INVALID_REGION_CODE رمز المنطقة غير صالح.
INVALID_SUBDIVISION_CODE رمز التقسيم الفرعي غير صالح.
INVALID_SUBCONTINENT_CODE رمز المنطقة الفرعية غير صالح.
INVALID_CONTINENT_CODE رمز القارة غير صالح.
INVALID_DEVICE_CATEGORY فئة الجهاز غير صالحة.
BOTH_CLIENT_ID_AND_APP_INSTANCE_ID_NOT_ALLOWED تم ضبط كلّ من app_instance_id وclient_id.
GOOGLE_ANALYTICS_SUBPROPERTY_OR_ROLLUP_PROPERTY_NOT_ALLOWED موقع على "إحصاءات Google" هو موقع فرعي أو موقع بيانات مجمّعة.
THIRD_PARTY_USER_DATA_NOT_ALLOWED يمكن لشركاء البيانات فقط ضبط بيانات المستخدمين التابعة لجهات خارجية.
INVALID_COUPON_CODE رمز القسيمة غير صالح.
EVENT_SOURCE_AND_DESTINATION_MISMATCH لا يتطابق نوع مصدر الحدث مع نوع الوجهة.
DESTINATION_ACCOUNT_TYPE_MISMATCH لا يتطابق نوع حساب الوجهة مع رقم تعريف الحساب المحدّد.
CUSTOM_VARIABLE_VALUE_CONTAINS_PII يحتوي المتغيّر المخصّص على معلومات تكشف الهوية الشخصية (PII).
CUSTOM_VARIABLE_NOT_ENABLED المتغيّر المخصّص غير مُفعَّل.
INVALID_CUSTOM_VARIABLE_VALUE قيمة المتغيّر المخصّص غير صالحة.
CUSTOM_VARIABLE_NOT_FOUND لا تتضمّن الوجهة متغيّرًا مخصّصًا باسم يطابق variable المحدّد.
TOO_MANY_USERS الحد الأقصى لعدد المستخدمين المسموح بهم لكل طلب هو 10,000.
BASELINE_LOCATION_AUTO_DETECTION_FAILED تم ضبط الحقل location_auto_detection_enabled في الطلب على true، ولكن تعذّر الرصد التلقائي للموقع الجغرافي الأساسي.
INSIGHTS_MISSING_FOR_DIMENSION لا تتوفّر إحصاءات لهذه السمة.
INVALID_REMOVE_AS_OF_TIME يجب أن يكون وقت الإزالة في الماضي أو الحاضر. لا يُسمح باستخدام طوابع زمنية مستقبلية لإزالة أعضاء الجمهور.
REQUEST_TOO_OLD تتوفّر حالة الطلب لمدة 50 يومًا تقريبًا فقط بعد أن تتلقّى واجهة برمجة التطبيقات طلبًا.
CONVERSION_ACTION_TOO_RECENTLY_CREATED تم إنشاء إجراء الإحالة الناجحة قبل وقت قصير جدًا.
INVALID_AD_IDENTIFIER_FOR_ACCOUNT

لا ينتمي معرّف الإعلان إلى الحساب.

على سبيل المثال، لا يرتبط gclid بـ operating_account وproduct_destination_id الخاصين بالوجهة.

الحدث

حدث يمثّل تفاعل مستخدم مع موقع إلكتروني أو تطبيق خاص بأحد المعلِنين.

الحقول
destination_references[]

string

اختيارية: سلسلة مرجعية تُستخدَم لتحديد الوجهة. إذا كان هذا الحقل فارغًا، سيتم إرسال الحدث إلى جميع destinations في الطلب.
transaction_id

string

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

Timestamp

الحقل مطلوب. الوقت الذي وقع فيه الحدث
last_updated_timestamp

Timestamp

اختيارية: يشير هذا الحقل إلى تاريخ آخر مرة تم فيها تعديل الحدث.
user_data

UserData

اختيارية: أجزاء من البيانات المقدَّمة من المستخدِم، وتمثّل المستخدِم المرتبط بالحدث.
consent

Consent

اختيارية: معلومات عمّا إذا كان المستخدم المرتبط قد قدّم أنواعًا مختلفة من الموافقة.
ad_identifiers

AdIdentifiers

اختيارية: المعرّفات والمعلومات الأخرى المستخدَمة لمطابقة حدث الإحالة الناجحة مع النشاط الآخر على الإنترنت (مثل النقرات على الإعلانات)
currency

string

اختيارية: رمز العملة المرتبط بجميع القيم النقدية ضِمن هذا الحدث.
event_source

EventSource

اختيارية: إشارة إلى المكان الذي وقع فيه الحدث (الويب أو التطبيق أو داخل المتجر أو غير ذلك)
event_device_info

DeviceInfo

اختيارية: معلومات يتم جمعها عن الجهاز المستخدَم (إن وُجد) عند وقوع الحدث
cart_data

CartData

اختيارية: معلومات عن المعاملة والسلع المرتبطة بالحدث
custom_variables[]

CustomVariable

اختيارية: معلومات إضافية عن أزواج المفاتيح/القيم لإرسالها إلى حاويات الإحالات الناجحة (إجراء الإحالة الناجحة أو نشاط Floodlight).
experimental_fields[]

ExperimentalField

اختيارية: قائمة بأزواج المفاتيح والقيم للحقول التجريبية التي قد تتم ترقيتها في النهاية لتصبح جزءًا من واجهة برمجة التطبيقات.
user_properties

UserProperties

اختيارية: معلومات يقدّمها المعلِن عن المستخدِم في وقت وقوع الحدث.
event_name

string

اختيارية: اسم الحدث مطلوب لأحداث "إحصاءات Google‏ 4".
client_id

string

اختيارية: معرّف فريد لمثيل المستخدم لبرنامج الويب لهذا المصدر على الويب في "إحصاءات Google‏ 4"
user_id

string

اختيارية: معرّف فريد للمستخدِم، كما يحدّده المعلِن.
additional_event_parameters[]

EventParameter

اختيارية: مجموعة من أي مَعلمات أحداث سيتم تضمينها في الحدث ولم يتم تحديدها من قبل باستخدام حقول منظَّمة أخرى
third_party_user_data

UserData

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

EventLocation

اختيارية: معلومات تم جمعها عن الموقع الجغرافي للمستخدم عند وقوع هذا الحدث.
app_instance_id

string

اختيارية: معرّف فريد لمثيل مستخدم لأحد عملاء التطبيق في مصدر بيانات التطبيق هذا على "إحصاءات Google‏ 4"
conversion_value

double

اختيارية: قيمة الإحالة الناجحة المرتبطة بالحدث، وذلك للإحالات الناجحة المستندة إلى القيمة
conversion_count

double

اختيارية: كمية الإحالة الناجحة المرتبطة بالحدث، وذلك للإحالات الناجحة المستندة إلى العدّ

EventLocation

تمثّل هذه السمة الموقع الجغرافي حيث ستقام الفعالية.

الحقول
store_id

string

اختيارية: هذه السمة مطلوبة لخدمة "مبيعات المتجر". المعرّف الذي يمثّل متجرًا فعليًا حدث فيه الحدث.
city

string

اختيارية: اسم المدينة التي وقع فيها الحدث
subdivision_code

string

اختيارية: رمز التقسيم الفرعي وفقًا لمعيار ISO 3166-2 الذي وقع فيه الحدث.
region_code

string

اختيارية: رمز منطقة CLDR المكوّن من حرفَين والذي يقع فيه عنوان المستخدِم
subcontinent_code

string

اختيارية: رمز شبه القارة بتنسيق UN M49 حيث وقع الحدث
continent_code

string

اختيارية: رمز القارة بتنسيق UN M49 حيث وقع الحدث

EventParameter

مَعلمة خاصة بالحدث لأحداث "إحصاءات Google‏ 4".

الحقول
parameter_name

string

الحقل مطلوب. اسم المَعلمة المطلوب استخدامها.
value

string

الحقل مطلوب. تمثيل السلسلة لقيمة المَعلمة المطلوب ضبطها

EventSource

تمثّل هذه السمة مصدر الحدث.

عمليات التعداد
EVENT_SOURCE_UNSPECIFIED Unspecified EventSource. يجب عدم استخدامها مطلقًا.
WEB تم إنشاء الحدث من متصفّح ويب.
APP تم إنشاء الحدث من تطبيق.
IN_STORE تم إنشاء الحدث من معاملة داخل المتجر.
PHONE تم إنشاء الحدث من مكالمة هاتفية.
MESSAGE تم إنشاء الحدث من رسالة.
OTHER تم إنشاء الحدث من مصادر أخرى.

ExperimentalField

حقل تجريبي يمثّل الحقول غير الرسمية.

الحقول
field

string

اختيارية: اسم الحقل المطلوب استخدامه
value

string

اختيارية: القيمة التي سيتم ضبطها للحقل.

FeatureSet

مجموعة الميزات المتوافقة مع رابط الشريك

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

FieldWarning

تحذير تفصيلي على مستوى الصف مع مسارات الحقول

الحقول
reason

WarningReason

سبب التحذير
description

string

رسالة التحذير المفصَّلة التي تصف المشكلة
field

string

مسار الحقل الذي أدّى إلى ظهور التحذير. يستخدم التنسيق نفسه المستخدَم في google.rpc.BadRequest.FieldViolation.field.

GcpWrappedKeyInfo

معلومات حول مفتاح التشفير الملتفّ في Google Cloud Platform

الحقول
key_type

KeyType

الحقل مطلوب. نوع الخوارزمية المستخدَمة لتشفير البيانات
wip_provider

string

الحقل مطلوب. موفِّر مجموعة Workload Identity المطلوب لاستخدام مفتاح تشفير المفاتيح (KEK)
kek_uri

string

الحقل مطلوب. معرّف مورد Cloud Key Management Service في Google Cloud Platform يجب أن يكون بالتنسيق projects/{project}/locations/{location}/keyRings/{key_ring}/cryptoKeys/{key} أو gcp-kms://projects/{project}/locations/{location}/keyRings/{key_ring}/cryptoKeys/{key}
encrypted_dek

string

الحقل مطلوب. مفتاح تشفير البيانات المشفّر المرمّز باستخدام Base64

KeyType

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

عمليات التعداد
KEY_TYPE_UNSPECIFIED نوع المفتاح غير محدَّد. يجب عدم استخدامها مطلقًا.
XCHACHA20_POLY1305 الخوارزمية XChaCha20-Poly1305

الجنس

نوع الجنس الديمغرافي (على سبيل المثال، أنثى)

عمليات التعداد
GENDER_UNSPECIFIED لم يتم تحديد أي قيمة.
GENDER_UNKNOWN غير معروف.
GENDER_MALE ذكر
GENDER_FEMALE أنثى

GetUserListDirectLicenseRequest

طلب الحصول على مرجع UserListDirectLicense

يمكنك تجربة هذه الطريقة في مستكشف واجهات REST API:
تجربة REST
الحقول
name

string

الحقل مطلوب. اسم المورد لترخيص قائمة المستخدمين المباشر.

GetUserListGlobalLicenseRequest

طلب الحصول على مرجع UserListGlobalLicense

يمكنك تجربة هذه الطريقة في مستكشف REST API:
تجربة REST
الحقول
name

string

الحقل مطلوب. اسم المورد لترخيص قائمة المستخدمين على مستوى العالم.

GetUserListRequest

رسالة الطلب الخاصة بوظيفة GetUserList

يمكنك تجربة هذه الطريقة في مستكشف REST API:
تجربة REST
الحقول
name

string

الحقل مطلوب. اسم المورد الخاص بقائمة المستخدمين المطلوب استردادها. التنسيق: accountTypes/{account_type}/accounts/{account}/userLists/{user_list}

GoogleUserIdData

بيانات أرقام تعريف مستخدمي Google التي تتضمّن أرقام تعريف مشفّرة لمستخدمي Google يجب توفير رقم تعريف مستخدم واحد على الأقل على Google.

الحقول
google_user_ids[]

string

الحقل مطلوب. قائمة بمعرّفات مستخدمي Google المشفّرة.

IngestAdEventsRequest

طلب تحميل أحداث الإعلانات

يمكنك تجربة هذه الطريقة في مستكشف واجهات REST API:
تجربة REST
الحقول
ad_events[]

AdEvent

الحقل مطلوب. مطلوب (يجب توفير قيمة واحدة على الأقل). قائمة بأحداث الإعلانات
encryption_info

EncryptionInfo

اختيارية: معلومات عن مفاتيح التشفير المستخدَمة لتشفير البيانات يجب توفير هذا الحقل عندما تحتوي أحداث الإعلانات على UserData.
validate_only
(deprecated)

bool

اختيارية: إذا كانت القيمة صحيحة، يتم التحقّق من صحة الطلب، ولكن لا يتم تنفيذه.

IngestAdEventsResponse

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

ردّ من عملية استيعاب حدث إعلان.

IngestAudienceMembersRequest

طلب تحميل أعضاء الجمهور إلى الوجهات المقدَّمة تعرض IngestAudienceMembersResponse.

يمكنك تجربة هذه الطريقة في مستكشف واجهات REST API:
تجربة REST
الحقول
destinations[]

Destination

الحقل مطلوب. قائمة الوجهات التي سيتم توجيه أفراد الجمهور إليها.
audience_members[]

AudienceMember

الحقل مطلوب. قائمة المستخدمين الذين سيتم إرسالهم إلى الوجهات المحدّدة يمكن إرسال 10,000 مورد AudienceMember كحدّ أقصى في طلب واحد.
consent

Consent

اختيارية: الموافقة على مستوى الطلب لتطبيقها على جميع المستخدمين في الطلب تتجاوز الموافقة على مستوى المستخدم الموافقة على مستوى الطلب، ويمكن تحديدها في كل AudienceMember.
validate_only

bool

اختيارية: لأغراض الاختبار إذا كانت القيمة true، يتم التحقّق من صحة الطلب ولكن لا يتم تنفيذه. يتم عرض الأخطاء فقط، وليس النتائج.
encoding

Encoding

اختيارية: يجب توفيرها لتحميل UserData. نوع الترميز لمعرّفات المستخدمين بالنسبة إلى معرّفات المستخدمين المجزّأة، هذا هو نوع الترميز للسلسلة المجزّأة. بالنسبة إلى معرّفات المستخدمين المجزّأة والمشفّرة، يكون هذا هو نوع الترميز للسلسلة الخارجية المشفّرة، ولكن ليس بالضرورة السلسلة الداخلية المجزّأة، ما يعني أنّه يمكن ترميز السلسلة الداخلية المجزّأة بطريقة مختلفة عن السلسلة الخارجية المشفّرة. يتم تجاهل هذا الحقل في عمليات التحميل التي لا تتضمّن UserData.
encryption_info

EncryptionInfo

اختيارية: معلومات التشفير لعمليات تحميل UserData في حال عدم ضبط هذا الخيار، يُفترض أنّ المعلومات التعريفية المحمَّلة مجزّأة ولكنّها غير مشفّرة. يتم تجاهل هذا الحقل في عمليات التحميل التي لا تتضمّن UserData.
terms_of_service

TermsOfService

اختيارية: بنود الخدمة التي قبلها المستخدم أو رفضها.

IngestAudienceMembersResponse

ردّ من IngestAudienceMembersRequest

الحقول
request_id

string

المعرّف الذي يتم إنشاؤه تلقائيًا للطلب.
field_warnings[]

FieldWarning

تحذيرات تفصيلية على مستوى الصف مع مسارات الحقول

IngestEventsRequest

طلب تحميل أعضاء الجمهور إلى الوجهات المقدَّمة تعرض IngestEventsResponse.

يمكنك تجربة هذه الطريقة في مستكشف واجهات REST API:
تجربة REST
الحقول
destinations[]

Destination

الحقل مطلوب. قائمة الوجهات التي سيتم إرسال الأحداث إليها.
events[]

Event

الحقل مطلوب. قائمة الأحداث المطلوب إرسالها إلى الوجهات المحدّدة يمكن إرسال 2,000 مورد Event كحد أقصى في طلب واحد.
consent

Consent

اختيارية: الموافقة على مستوى الطلب لتطبيقها على جميع المستخدمين في الطلب تتجاوز الموافقة على مستوى المستخدم الموافقة على مستوى الطلب، ويمكن تحديدها في كل Event.
validate_only

bool

اختيارية: لأغراض الاختبار إذا كانت القيمة true، يتم التحقّق من صحة الطلب ولكن لا يتم تنفيذه. يتم عرض الأخطاء فقط، وليس النتائج.
encoding

Encoding

اختيارية: يجب توفيرها لتحميل UserData. نوع الترميز لمعرّفات المستخدمين بالنسبة إلى معرّفات المستخدمين المجزّأة، هذا هو نوع الترميز للسلسلة المجزّأة. بالنسبة إلى معرّفات المستخدمين المجزّأة والمشفّرة، يكون هذا هو نوع الترميز للسلسلة الخارجية المشفّرة، ولكن ليس بالضرورة السلسلة الداخلية المجزّأة، ما يعني أنّه يمكن ترميز السلسلة الداخلية المجزّأة بطريقة مختلفة عن السلسلة الخارجية المشفّرة. يتم تجاهل هذا الحقل في عمليات التحميل التي لا تتضمّن UserData.
encryption_info

EncryptionInfo

اختيارية: معلومات التشفير لعمليات تحميل UserData في حال عدم ضبط هذا الخيار، يُفترض أنّ المعلومات التعريفية المحمَّلة مجزّأة ولكنّها غير مشفّرة. يتم تجاهل هذا الحقل في عمليات التحميل التي لا تتضمّن UserData.

IngestEventsResponse

ردّ من IngestEventsRequest

الحقول
request_id

string

المعرّف الذي يتم إنشاؤه تلقائيًا للطلب.
field_warnings[]

FieldWarning

تحذيرات تفصيلية على مستوى الصف مع مسارات الحقول

IngestUsersRequest

طلب تحميل المستخدمين إلى الوجهات المقدَّمة

يمكنك تجربة هذه الطريقة في مستكشف REST API:
تجربة REST
الحقول
destinations[]

Destination

الحقل مطلوب. قائمة بوجهات النقل المحتملة
users[]

User

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

EncryptionInfo

اختيارية: معلومات التشفير حول مفاتيح التشفير المستخدَمة لتشفير البيانات
validate_only

bool

اختيارية: إذا كانت القيمة true، يتم التحقّق من صحة الطلب ولكن لا يتم تنفيذه.
encoding

Encoding

الحقل مطلوب. نوع الترميز لمعرّفات المستخدمين بالنسبة إلى معرّفات المستخدمين المشفّرة، ينطبق ذلك فقط على الترميز الخارجي.

IngestUsersResponse

الردّ من IngestUsersRequest

الحقول
request_id

string

معرّف الطلب الذي تم إنشاؤه لطلب الاستيعاب

IngestedUserListInfo

تمثّل هذه السمة قائمة مستخدمين يتمّ ملؤها بالبيانات المقدَّمة من المستخدم.

الحقول
upload_key_types[]

UploadKeyType

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

ContactIdInfo

اختيارية: معلومات إضافية عندما يكون CONTACT_ID أحد upload_key_types
mobile_id_info

MobileIdInfo

اختيارية: معلومات إضافية عندما يكون MOBILE_ID أحد upload_key_types
user_id_info

UserIdInfo

اختيارية: معلومات إضافية عندما يكون USER_ID أحد upload_key_types
pair_id_info

PairIdInfo

اختيارية: معلومات إضافية عندما يكون PAIR_ID أحد upload_key_types

لا تتوفّر هذه الميزة إلا لشركاء البيانات.
pseudonymous_id_info

PseudonymousIdInfo

اختيارية: المعلومات الإضافية الخاصة بـ "PSEUDONYMOUS_ID" هي إحدى upload_key_types.
partner_audience_info

PartnerAudienceInfo

اختيارية: معلومات إضافية عن شرائح جمهور الشركاء

لا تتوفّر هذه الميزة إلا لشركاء البيانات.

UploadKeyType

تعداد يحتوي على أنواع مفاتيح التحميل المحتملة لقائمة مستخدمين.

عمليات التعداد
UPLOAD_KEY_TYPE_UNSPECIFIED لم يتم تحديد أي قيمة.
CONTACT_ID معلومات العملاء، مثل عنوان البريد الإلكتروني أو رقم الهاتف أو العنوان الجغرافي
MOBILE_ID معرّفات الإعلانات على الأجهزة الجوّالة
USER_ID معرّفات المستخدمين التي تقدّمها جهات خارجية
PAIR_ID أرقام التعريف التي يتم استخدامها لمطابقة هوية المعلِن مع الناشر
PSEUDONYMOUS_ID

معرّفات منصة إدارة البيانات:

  • معرّف مستخدم Google
  • المعرّف الذي يقدّمه الشريك
  • المعرّف المقدَّم من الناشر
  • معرّف المعلِنين (IDFA) على iOS
  • المعرّف الإعلاني على Android
  • معرّف Roku
  • معرّف Amazon Fire TV
  • معرّف Xbox أو Microsoft
  • رقم تعريف الجهاز العام

IpData

معلومات عنوان IP الخاص بالمستخدم ننصحك بتضمين observe_start_time وobserve_end_time للمساعدة في تحسين نِسب المطابقة في "مطابقة العملاء".

الحقول
ip_address

string

الحقل مطلوب. عنوان IP الذي تم تسجيله في وقت تفاعل العميل يقبل تنسيقات السلاسل العادية لكل من IPv4 وIPv6.
observe_start_time

Timestamp

اختيارية: وقت أول تفاعل تم تسجيله من عنوان IP هذا في جلسة
observe_end_time

Timestamp

اختيارية: وقت آخر تفاعل تم تسجيله من عنوان IP هذا في جلسة

العنصر

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

الحقول
merchant_product_id

string

اختيارية: معرّف المنتج في حساب Merchant Center
quantity

int64

اختيارية: عدد هذه السلعة المرتبطة بالحدث
unit_price

double

اختيارية: سعر الوحدة غير شامل للضرائب أو تكاليف الشحن أو أيّ خصومات على مستوى المُعاملة.
item_id

string

اختيارية: معرّف فريد للإشارة إلى المنتج.
additional_item_parameters[]

ItemParameter

اختيارية: مجموعة من مَعلمات الأحداث ذات الصلة بسلعة سيتم تضمينها في الحدث ولم يتم تحديدها من قبل باستخدام حقول منظَّمة أخرى
merchant_id

string

اختيارية: معرّف Merchant Center المرتبط بالسلعة. بالنسبة إلى أحداث "المبيعات في المتجر"، سيؤدي ذلك إلى إلغاء القيمة التي تم ضبطها على مستوى سلة التسوّق. ويتم تجاهل هذا الحقل للأحداث الأخرى.
merchant_feed_label

string

اختيارية: تصنيف الخلاصة في Merchant Center إذا كان يتم استخدام البلدان، يمكن استخدام رمز البلد المكوّن من حرفَين حسب المعيار ISO-3166-1 alpha-2 بدلاً من ذلك. بالنسبة إلى أحداث "المبيعات في المتجر"، سيؤدي ذلك إلى إلغاء القيمة التي تم ضبطها على مستوى سلة التسوّق. ويتم تجاهل هذا الحقل للأحداث الأخرى.
merchant_feed_language_code

string

اختيارية: رمز اللغة في معيار ISO 639-1 المرتبط بخلاصة Merchant Center التي يتم تحميل سلعك فيها
custom_variables[]

ItemCustomVariable

اختيارية: معلومات إضافية عن أزواج المفاتيح/القيم لإرسالها إلى حاويات الإحالات الناجحة (إجراء الإحالة الناجحة أو نشاط Floodlight)، عند تتبُّع الإحالات الناجحة لكل عنصر
conversion_value

double

اختيارية: قيمة الإحالة الناجحة المرتبطة بهذا المنتج أو الخدمة ضمن الحدث، وذلك في الحالات التي تختلف فيها قيمة الإحالة الناجحة لكل منتج أو خدمة.

ItemCustomVariable

متغيّر مخصّص على مستوى المنتج أو الخدمة لإحالات ناجحة من الإعلانات

الحقول
variable

string

اختيارية: اسم المتغيّر المخصّص الذي سيتم ضبطه. إذا لم يتم العثور على المتغيّر للوجهة المحدّدة، سيتم تجاهله.
value

string

اختيارية: القيمة المطلوب تخزينها للمتغيّر المخصّص.
destination_references[]

string

اختيارية: سلسلة مرجعية تُستخدَم لتحديد Event.destination_references الذي يجب إرسال المتغيّر المخصّص إليه. في حال تركها فارغة، سيتم استخدام Event.destination_references.

ItemParameter

مجموعة من مَعلمات الأحداث ذات الصلة بسلعة سيتم تضمينها في الحدث ولم يتم تحديدها من قبل باستخدام حقول منظَّمة أخرى

الحقول
parameter_name

string

الحقل مطلوب. اسم المَعلمة المطلوب استخدامها.
value

string

الحقل مطلوب. تمثيل السلسلة لقيمة المَعلمة المطلوب ضبطها

ListUserListDirectLicensesRequest

طلب إدراج جميع موارد UserListDirectLicense لحساب معيّن

يمكنك تجربة هذه الطريقة في مستكشف واجهات REST API:
تجربة REST
الحقول
parent

string

الحقل مطلوب. الحساب الذي يتم الاستعلام عن تراخيصه. يجب أن يكون بالتنسيق accountTypes/{ACCOUNT_TYPE}/accounts/{ACCOUNT_ID}
filter

string

اختيارية: سلسلة فلتر لتطبيقها على طلب القائمة يجب أن تكون جميع الحقول على الجانب الأيمن من كل شرط (على سبيل المثال: user_list_id = 123). يجب تحديد الحقول باستخدام camel case أو snake case. لا تستخدِم مزيجًا من تنسيق Camel Case وتنسيق Snake Case.

العمليات المتوافقة:

  • AND
  • =
  • !=
  • >
  • >=
  • <
  • <=

الدوال المتوافقة: - IN(field, value1, value2, ...): تعرض القيمة "صحيح" إذا كان الحقل يطابق أيًا من القيم. مثال: IN(user_list_id, 123, 456)

الحقول غير المتوافقة:

  • ‫name (استخدِم طريقة get بدلاً من ذلك)
  • ‫historical_pricings وجميع حقوله الفرعية
  • pricing.start_time
  • pricing.end_time
page_size

int32

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

string

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

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

ListUserListDirectLicensesResponse

ردّ من ListUserListDirectLicensesRequest

الحقول
user_list_direct_licenses[]

UserListDirectLicense

تراخيص قائمة المستخدمين المحدّدة في الطلب
next_page_token

string

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

ListUserListGlobalLicenseCustomerInfosRequest

طلب إدراج جميع موارد UserListGlobalLicenseCustomerInfo لقائمة مستخدمين معيّنة بترخيص عالمي.

يمكنك تجربة هذه الطريقة في مستكشف واجهات REST API:
تجربة REST
الحقول
parent

string

الحقل مطلوب. الترخيص العالمي الذي يتم الاستعلام عن معلومات العميل المرتبطة به. يجب أن يكون بالتنسيق accountTypes/{ACCOUNT_TYPE}/accounts/{ACCOUNT_ID}/userListGlobalLicenses/{USER_LIST_GLOBAL_LICENSE_ID}. لإدراج جميع معلومات العملاء الذين لديهم ترخيص عالمي ضمن حساب، استبدِل رقم تعريف الترخيص العالمي لقائمة المستخدمين بعلامة "-" (على سبيل المثال، accountTypes/DATA_PARTNER/accounts/123/userListGlobalLicenses/-).
filter

string

اختيارية: سلسلة فلتر لتطبيقها على طلب القائمة يجب أن تكون جميع الحقول على الجانب الأيمن من كل شرط (على سبيل المثال: user_list_id = 123). يجب تحديد الحقول باستخدام camel case أو snake case. لا تستخدِم مزيجًا من تنسيق Camel Case وتنسيق Snake Case.

العمليات المتوافقة:

  • AND
  • =
  • !=
  • >
  • >=
  • <
  • <=

الدوال المتوافقة: - IN(field, value1, value2, ...): تعرض القيمة "صحيح" إذا كان الحقل يطابق أيًا من القيم. مثال: IN(user_list_id, 123, 456)

الحقول غير المتوافقة:

  • ‫name (استخدِم طريقة get بدلاً من ذلك)
  • ‫historical_pricings وجميع حقوله الفرعية
  • pricing.start_time
  • pricing.end_time
page_size

int32

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

string

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

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

ListUserListGlobalLicenseCustomerInfosResponse

الردّ من [ListUserListGlobalLicensesCustomerInfoRequest][google.ads.datamanager.v1.ListUserListGlobalLicensesCustomerInfoRequest].

الحقول
user_list_global_license_customer_infos[]

UserListGlobalLicenseCustomerInfo

معلومات العميل الخاصة بالترخيص المحدّد في الطلب
next_page_token

string

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

ListUserListGlobalLicensesRequest

طلب إدراج جميع موارد UserListGlobalLicense لحساب معيّن

يمكنك تجربة هذه الطريقة في مستكشف REST API:
تجربة REST
الحقول
parent

string

الحقل مطلوب. الحساب الذي يتم الاستعلام عن تراخيصه. يجب أن يكون بالتنسيق accountTypes/{ACCOUNT_TYPE}/accounts/{ACCOUNT_ID}
filter

string

اختيارية: سلسلة فلتر لتطبيقها على طلب القائمة يجب أن تكون جميع الحقول على الجانب الأيمن من كل شرط (على سبيل المثال: user_list_id = 123). يجب تحديد الحقول باستخدام camel case أو snake case. لا تستخدِم مزيجًا من تنسيق Camel Case وتنسيق Snake Case.

العمليات المتوافقة:

  • AND
  • =
  • !=
  • >
  • >=
  • <
  • <=

الدوال المتوافقة: - IN(field, value1, value2, ...): تعرض القيمة "صحيح" إذا كان الحقل يطابق أيًا من القيم. مثال: IN(user_list_id, 123, 456)

الحقول غير المتوافقة:

  • ‫name (استخدِم طريقة get بدلاً من ذلك)
  • ‫historical_pricings وجميع حقوله الفرعية
  • pricing.start_time
  • pricing.end_time
page_size

int32

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

string

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

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

ListUserListGlobalLicensesResponse

ردّ من ListUserListGlobalLicensesRequest

الحقول
user_list_global_licenses[]

UserListGlobalLicense

تراخيص قائمة المستخدمين المحدّدة في الطلب
next_page_token

string

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

ListUserListsRequest

رسالة الطلب الخاصة بـ ListUserLists

يمكنك تجربة هذه الطريقة في مستكشف واجهات REST API:
تجربة REST
الحقول
parent

string

الحقل مطلوب. الحساب الرئيسي الذي يملك هذه المجموعة من قوائم المستخدمين. التنسيق: accountTypes/{account_type}/accounts/{account}
page_size

int32

اختيارية: الحدّ الأقصى لعدد قوائم المستخدمين التي سيتم عرضها قد تعرض الخدمة عددًا أقل من هذه القيمة. إذا لم يتم تحديدها، سيتم عرض 50 قائمة مستخدمين على الأكثر. الحد الأقصى للقيمة هو 1000، وسيتم فرض القيمة 1000 على القيم الأعلى من 1000.
page_token

string

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

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

string

اختيارية: سلسلة فلترة يجب أن تكون جميع الحقول على الجانب الأيمن من كل شرط (على سبيل المثال: display_name = "list 1"). يجب تحديد الحقول باستخدام camel case أو snake case. لا تستخدِم مزيجًا من تنسيق Camel Case وتنسيق Snake Case.

العمليات المتوافقة:

  • AND
  • =
  • !=
  • >
  • >=
  • <
  • <=
  • ‫: (يملك)

الدوال المتوافقة: - IN(field, value1, value2, ...): تعرض القيمة "صحيح" إذا كان الحقل يطابق أيًا من القيم. مثال: IN(display_name, "name1", "name2")

الحقول المتوافقة:

  • id
  • display_name
  • description
  • membership_status
  • integration_code
  • access_reason
  • ingested_user_list_info.upload_key_types

ListUserListsResponse

رسالة الردّ على ListUserLists

الحقول
user_lists[]

UserList

قوائم المستخدمين من الحساب المحدّد
next_page_token

string

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

MatchRateRange

نطاق نسبة المطابقة لعملية التحميل أو قائمة المستخدمين

عمليات التعداد
MATCH_RATE_RANGE_UNKNOWN نطاق معدّل المطابقة غير معروف.
MATCH_RATE_RANGE_NOT_ELIGIBLE نطاق معدّل المطابقة غير مؤهَّل.
MATCH_RATE_RANGE_LESS_THAN_20 نطاق نسبة المطابقة أقل من ‎20% (في الفاصل الزمني [0, 20)).
MATCH_RATE_RANGE_20_TO_30 يتراوح نطاق نسبة المطابقة بين ‎20% و‎30% (في الفترة [20, 31)).
MATCH_RATE_RANGE_31_TO_40 يتراوح نطاق نسبة المطابقة بين ‎31% و‎40% (في الفترة [31, 41)).
MATCH_RATE_RANGE_41_TO_50 يتراوح نطاق نسبة المطابقة بين% 41 و%50 (في الفترة [41, 51)).
MATCH_RATE_RANGE_51_TO_60 يتراوح نطاق نسبة المطابقة بين ‎51% و‎60% (في الفترة [51, 61).
MATCH_RATE_RANGE_61_TO_70 يتراوح نطاق نسبة المطابقة بين% 61 و%70 (في الفترة [61, 71)).
MATCH_RATE_RANGE_71_TO_80 يتراوح نطاق نسبة المطابقة بين ‎71% و‎80% (في الفترة [71, 81)).
MATCH_RATE_RANGE_81_TO_90 يتراوح نطاق نسبة المطابقة بين ‎81% و‎90% (في الفترة [81, 91)).
MATCH_RATE_RANGE_91_TO_100

يتراوح نطاق نسبة المطابقة بين ‎91% و‎100% (في الفترة [91, 100]).

MediaQuartile

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

عمليات التعداد
MEDIA_QUARTILE_UNSPECIFIED الربيعي غير المحدّد للوسائط
MEDIA_QUARTILE_START زر البدء:
MEDIA_QUARTILE_FIRST_QUARTILE الربع الأول
MEDIA_QUARTILE_MIDPOINT المنتصف
MEDIA_QUARTILE_THIRD_QUARTILE الربع الثالث
MEDIA_QUARTILE_COMPLETE مكتملة

MobileData

معرّفات الأجهزة الجوّالة للجمهور يجب توفير معرّف جهاز جوّال واحد على الأقل.

الحقول
mobile_ids[]

string

الحقل مطلوب. قائمة بأرقام تعريف الأجهزة الجوّالة (المعرّف الإعلاني على Android أو معرّف المعلِنين على iOS لقوائم مستخدمي "مطابقة العملاء"، والمعرّف الإعلاني على Android أو معرّف المعلِنين على iOS أو معرّف Xbox أو Microsoft أو معرّف Amazon Fire TV أو معرّف Roku أو معرّف الجهاز العام لقوائم المستخدمين الأساسية) يمكن تقديم 10 mobileIds كحد أقصى في AudienceMember واحد.

MobileIdInfo

معلومات إضافية عندما يكون MOBILE_ID أحد upload_key_types

الحقول
data_source_type

DataSourceType

اختيارية: غير قابل للتغيير. تمثّل هذه السمة مصدر بيانات التحميل.
key_space

KeySpace

الحقل مطلوب. غير قابل للتغيير. مساحة المفاتيح لمعرّفات الأجهزة الجوّالة
app_id

string

الحقل مطلوب. غير قابل للتغيير. سلسلة تحدّد بشكلٍ فريد تطبيقًا على الأجهزة الجوّالة تم جمع البيانات منه.

KeySpace

مساحة المفتاح لمعرّف الجهاز الجوّال

عمليات التعداد
KEY_SPACE_UNSPECIFIED لم يتم تحديد أي قيمة.
IOS مساحة مفاتيح iOS
ANDROID مساحة مفاتيح Android

PairData

معرّفات PAIR للجمهور يجب توفير رقم تعريف PAIR واحد على الأقل.

لا تتوفّر هذه الميزة إلا لشركاء البيانات.

الحقول
pair_ids[]

string

الحقل مطلوب. بيانات معلومات تكشف الهوية الشخصية المقدَّمة من Clean Room، والمجزّأة باستخدام خوارزمية SHA256، والمشفّرة باستخدام تشفير تبادلي EC باستخدام مفتاح الناشر لقائمة مستخدمي PAIR يمكن تقديم 10 pairIds كحد أقصى في AudienceMember واحد.

PairIdInfo

معلومات إضافية عندما يكون PAIR_ID أحد upload_key_types

لا تتوفّر هذه الميزة إلا لشركاء البيانات.

الحقول
publisher_id

int64

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

string

الحقل مطلوب. اسم وصفي للناشر سيتم عرضه في واجهة المستخدم لتوفير تجربة استهداف أفضل.
match_rate_percentage

int32

الحقل مطلوب. يشير هذا الحقل إلى نسبة مطابقة العضوية في قائمة المستخدمين هذه مع بيانات الطرف الأول الخاصة بالناشر المعنيّ. يجب أن تتراوح القيمة بين 0 و100 (بما في ذلك هذان الرقمان).
advertiser_identifier_count

int64

اختيارية: عدد سجلّات بيانات الطرف الأوّل للمعلِن التي تمّ تحميلها إلى مقدّم خدمة تقنية clean room. لا يشير ذلك إلى حجم قائمة مستخدمي PAIR.
clean_room_identifier

string

الحقل مطلوب. غير قابل للتغيير. تحدّد هذه السمة علاقة فريدة بين المعلِن والناشر مع مقدّم خدمة واحد لتقنية clean room أو مع مقدّمي خدمات متعددين لتقنية clean room.

PartnerAudienceInfo

معلومات إضافية عن شرائح جمهور الشركاء

لا تتوفّر هذه الميزة إلا لشركاء البيانات.

الحقول
partner_audience_source

PartnerAudienceSource

الحقل مطلوب. غير قابل للتغيير. مصدر شرائح جمهور الشريك
commerce_partner

string

اختيارية: اسم شريك التجارة الإلكترونية يُسمح بذلك فقط إذا كانت قيمة partner_audience_source هي COMMERCE_AUDIENCE.

PartnerAudienceSource

مصدر بيانات عن الجمهور الخاص بالشريك

عمليات التعداد
PARTNER_AUDIENCE_SOURCE_UNSPECIFIED لم يتم تحديد أي قيمة.
COMMERCE_AUDIENCE مصدر بيانات عن الجمهور الخاص بالشريك هو جمهور التجارة.
LINEAR_TV_AUDIENCE مصدر بيانات عن الجمهور الشريك هو برامج تلفزيونية مُجدوَلة.
AGENCY_PROVIDER_AUDIENCE مصدر بيانات عن الجمهور الخاص بالشركاء هو شرائح جمهور الوكالة/المزود.

PartnerCustomerAccount

تمثّل حساب عميل في نظام الشريك.

الحقول
account_id

string

الحقل مطلوب. معرّف حساب العميل في مساحة المعرّفات الخاصة بالشريك
account_name

string

اختيارية: اسم الحساب
account_type

string

اختيارية: تمثّل هذه السمة نوع الحساب. يمكن استخدامها للتمييز بين حسابات المعلِنين والحسابات على مستوى المؤسسة، على سبيل المثال.

PartnerLinkMetadata

تمثّل هذه السمة البيانات الوصفية المرتبطة برابط شريك.

الحقول
implicit_accounts[]

PartnerCustomerAccount

اختيارية: قائمة الحسابات الضمنية

PartnerProvidedIdData

بيانات يقدّمها الشريك وتحتوي على المعرّفات التي يقدّمها الشريك يجب توفير معرّف واحد على الأقل مقدَّم من الشريك.

الحقول
partner_provided_ids[]

string

الحقل مطلوب. قائمة المعرّفات التي يقدّمها الشريك

النظام الأساسي

تفاصيل إضافية عن المنصة التي تم عرض الإعلان عليها

عمليات التعداد
PLATFORM_UNSPECIFIED نظام أساسي غير محدّد
PLATFORM_IOS نظام التشغيل iOS
PLATFORM_ANDROID نظام Android الأساسي
PLATFORM_WEB النظام الأساسي على الويب

PlatformType

نوع المنصة التي تم عرض الإعلان عليها.

عمليات التعداد
PLATFORM_TYPE_UNSPECIFIED نوع المنصة غير محدَّد.
PLATFORM_TYPE_MOBILE النظام الأساسي للأجهزة الجوّالة
PLATFORM_TYPE_DESKTOP النظام الأساسي لجهاز كمبيوتر سطح المكتب
PLATFORM_TYPE_CTV منصّة التلفزيون المتّصل
PLATFORM_TYPE_PHONE النظام الأساسي للهاتف
PLATFORM_TYPE_TABLET منصة الأجهزة اللوحية

PpidData

بيانات المعرّفات المقدَّمة من الناشر التي تتضمّن المعرّفات المقدَّمة من الناشر يجب توفير معرّف واحد على الأقل.

لا تتوفّر هذه الميزة إلا لشركاء البيانات.

الحقول
ppids[]

string

الحقل مطلوب. قائمة بالمعرّفات المقدَّمة من الناشر لمستخدِم.

ProcessingErrorReason

سبب الخطأ الذي حدث أثناء المعالجة قد تتم إضافة أسباب جديدة في المستقبل.

عمليات التعداد
PROCESSING_ERROR_REASON_UNSPECIFIED سبب خطأ المعالجة غير معروف.
PROCESSING_ERROR_REASON_INVALID_CUSTOM_VARIABLE المتغيّر المخصّص غير صالح.
PROCESSING_ERROR_REASON_CUSTOM_VARIABLE_NOT_ENABLED حالة المتغيّر المخصّص غير مفعَّلة.
PROCESSING_ERROR_REASON_EVENT_TOO_OLD الإحالة الناجحة أقدم من الحد الأقصى المسموح به للعمر.
PROCESSING_ERROR_REASON_DUPLICATE_GCLID تتوفّر إحالة ناجحة حالية مرتبطة بمعرّف النقرة من Google ‏(GCLID) ووقت الإحالة الناجحة نفسَيهما في النظام.
PROCESSING_ERROR_REASON_DUPLICATE_TRANSACTION_ID سبق أن تم تحميل إحالة ناجحة بنفس مُعرّف الطلب ومجموعة إجراء الإحالة الناجحة.
PROCESSING_ERROR_REASON_INVALID_GBRAID تعذّر فك ترميز مَعلمة gbraid.
PROCESSING_ERROR_REASON_INVALID_GCLID تعذّر فكّ ترميز معرّف النقرة من Google.
PROCESSING_ERROR_REASON_INVALID_MERCHANT_ID يحتوي معرّف التاجر على أحرف غير رقمية.
PROCESSING_ERROR_REASON_INVALID_WBRAID تعذّر فك ترميز مَعلمة wbraid.
PROCESSING_ERROR_REASON_INTERNAL_ERROR حدث خطأ داخلي.
PROCESSING_ERROR_REASON_DESTINATION_ACCOUNT_ENHANCED_CONVERSIONS_TERMS_NOT_SIGNED لم يتم توقيع بنود ميزة "الإحالات الناجحة المحسّنة" في حساب الوجهة.
PROCESSING_ERROR_REASON_INVALID_EVENT الحدث غير صالح.
PROCESSING_ERROR_REASON_INSUFFICIENT_MATCHED_TRANSACTIONS المعاملات المطابِقة أقل من الحدّ الأدنى.
PROCESSING_ERROR_REASON_INSUFFICIENT_TRANSACTIONS المعاملات أقل من الحد الأدنى.
PROCESSING_ERROR_REASON_INVALID_FORMAT يحتوي الحدث على خطأ في التنسيق.
PROCESSING_ERROR_REASON_DECRYPTION_ERROR يحدث خطأ في فك تشفير الحدث.
PROCESSING_ERROR_REASON_DEK_DECRYPTION_ERROR تعذّر فك تشفير مفتاح تشفير البيانات.
PROCESSING_ERROR_REASON_INVALID_WIP تم تنسيق رقم تعريف WIP بشكلٍ غير صحيح أو أنّ رقم تعريف WIP غير متوفّر.
PROCESSING_ERROR_REASON_INVALID_KEK لا يمكن لمفتاح تشفير المفتاح فك تشفير البيانات لأنّه مفتاح تشفير مفتاح غير صحيح أو غير متوفّر.
PROCESSING_ERROR_REASON_WIP_AUTH_FAILED تعذّر استخدام WIP لأنّه تم رفضه بسبب شرط التصديق.
PROCESSING_ERROR_REASON_KEK_PERMISSION_DENIED لم يكن لدى النظام الأذونات اللازمة للوصول إلى مفتاح تشفير المفاتيح.
PROCESSING_ERROR_REASON_AWS_AUTH_FAILED تعذّر على النظام إجراء المصادقة مع AWS.
PROCESSING_ERROR_REASON_USER_IDENTIFIER_DECRYPTION_ERROR تعذّر فك تشفير بيانات UserIdentifier باستخدام مفتاح تشفير البيانات.
PROCESSING_ERROR_OPERATING_ACCOUNT_MISMATCH_FOR_AD_IDENTIFIER حاول المستخدِم استيعاب الأحداث باستخدام معرّف إعلاني لا ينتمي إلى إعلانات الحساب التشغيلي.
PROCESSING_ERROR_REASON_ONE_PER_CLICK_CONVERSION_ACTION_NOT_PERMITTED_WITH_BRAID لا يمكن استخدام إجراءات الإحالات الناجحة التي تحتسب إحالة ناجحة واحدة بعد النقر مع مَعلمات BRAID.
PROCESSING_ERROR_REASON_MATCH_ID_NOT_FOUND يتعذّر العثور على رقم تعريف المباراة.
PROCESSING_ERROR_REASON_USER_ID_NOT_FOUND_FOR_MATCH_ID لم يتم العثور على رقم تعريف المستخدم لمعرّف المطابقة.
PROCESSING_ERROR_REASON_USER_ID_NOT_FOUND_FOR_GCLID لا يمكن العثور على رقم تعريف المستخدم لمعرّف النقرة من Google.
PROCESSING_ERROR_REASON_USER_ID_NOT_FOUND_FOR_DCLID لا يمكن العثور على رقم تعريف المستخدم لمعرّف النقر المزدوج.
PROCESSING_ERROR_REASON_INVALID_AD_IDENTIFIERS هناك معرّفات إعلانات غير صالحة.
PROCESSING_ERROR_REASON_INVALID_MOBILE_ID_FORMAT تنسيق رقم تعريف الجهاز الجوّال غير صالح.
PROCESSING_ERROR_REASON_ORIGINAL_CONVERSIONS_NOT_FOUND يتعذّر العثور على الإحالات الناجحة الأصلية.
PROCESSING_ERROR_REASON_EVENT_ID_DECODE_ERROR يتعذّر فكّ ترميز معرّف الحدث (dclid أو معرّف مرّة الظهور).
PROCESSING_ERROR_REASON_USER_ID_NOT_FOUND_FOR_IMPRESSION_ID لا يمكن العثور على رقم تعريف المستخدم لمعرّف مرّة الظهور المحدّد.
PROCESSING_ERROR_REASON_USER_ID_NOT_FOUND يتعذّر العثور على رقم تعريف المستخدم.
PROCESSING_ERROR_REASON_CONVERSION_PRECEDES_CLICK كان الطابع الزمني للحدث أقدم من النقرة المرتبطة به.
PROCESSING_ERROR_REASON_TOO_RECENT_CLICK حدثت النقرة قبل وقت قصير جدًا.
PROCESSING_ERROR_REASON_INVALID_CLICK لا يمكن تحديد مصدر الحدث بالاستناد إلى نقرة (GCLID). قد يعود السبب إلى أنّ هذه النقرة لم تنتج عن حملة على "إعلانات Google"، على سبيل المثال.
PROCESSING_ERROR_REASON_INVALID_OPERATING_ACCOUNT_FOR_CLICK لا ترتبط النقرة من الحدث بمعرّف operating_account للوجهة.
PROCESSING_ERROR_REASON_CLICK_NOT_FOUND يتعذّر العثور على نقرة مقابِلة تطابق السمات المقدَّمة.
PROCESSING_ERROR_REASON_EXTERNAL_ATTRIBUTION_DATA_MISSING بيانات تحديد المصدر الخارجية غير متوفّرة. لا تتوفّر إمكانية إرسال الأحداث إلى وجهة لإجراء إحالة ناجحة لتحديد المصدر الخارجي.

ProcessingWarningReason

سبب التحذير بشأن المعالجة

عمليات التعداد
PROCESSING_WARNING_REASON_UNSPECIFIED سبب تحذير المعالجة غير معروف.
PROCESSING_WARNING_REASON_KEK_PERMISSION_DENIED لم يكن لدى النظام الأذونات اللازمة للوصول إلى مفتاح تشفير المفاتيح.
PROCESSING_WARNING_REASON_DEK_DECRYPTION_ERROR تعذّر فك تشفير مفتاح تشفير البيانات.
PROCESSING_WARNING_REASON_DECRYPTION_ERROR يحدث خطأ في فك تشفير الحدث.
PROCESSING_WARNING_REASON_WIP_AUTH_FAILED تعذّر استخدام WIP لأنّه تم رفضه بسبب شرط التصديق.
PROCESSING_WARNING_REASON_INVALID_WIP تم تنسيق رقم تعريف WIP بشكلٍ غير صحيح أو أنّ رقم تعريف WIP غير متوفّر.
PROCESSING_WARNING_REASON_INVALID_KEK لا يمكن لمفتاح تشفير المفتاح فك تشفير البيانات لأنّه مفتاح تشفير مفتاح غير صحيح أو غير متوفّر.
PROCESSING_WARNING_REASON_USER_IDENTIFIER_DECRYPTION_ERROR تعذّر فك تشفير بيانات UserIdentifier باستخدام مفتاح تشفير البيانات.
PROCESSING_WARNING_REASON_INTERNAL_ERROR حدث خطأ داخلي.
PROCESSING_WARNING_REASON_AWS_AUTH_FAILED تعذّر على النظام إجراء المصادقة مع AWS.

المنتج

تمّ الإيقاف. يمكنك استخدام AccountType كبديل. تمثّل هذه السمة منتجًا معيّنًا من Google.

عمليات التعداد
PRODUCT_UNSPECIFIED منتج غير محدّد يجب عدم استخدامها مطلقًا.
GOOGLE_ADS إعلانات Google
DISPLAY_VIDEO_PARTNER شريك "مساحة العرض والفيديو 360"
DISPLAY_VIDEO_ADVERTISER مُعلِن على "مساحة العرض والفيديو 360"
DATA_PARTNER شريك البيانات:

ProductAccount

تمثّل حسابًا محدّدًا.

الحقول
product
(deprecated)

Product

تمّ الإيقاف. يمكنك استخدام account_type كبديل.
account_id

string

الحقل مطلوب. معرّف الحساب على سبيل المثال، معرّف حسابك على "إعلانات Google".
account_type

AccountType

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

AccountType

تمثّل هذه السمة أنواع حسابات Google. تُستخدَم لتحديد مواقع الحسابات والوجهات.

عمليات التعداد
ACCOUNT_TYPE_UNSPECIFIED منتج غير محدّد يجب عدم استخدامها مطلقًا.
GOOGLE_ADS إعلانات Google
DISPLAY_VIDEO_PARTNER شريك "مساحة العرض والفيديو 360"
DISPLAY_VIDEO_ADVERTISER مُعلِن على "مساحة العرض والفيديو 360"
DATA_PARTNER شريك البيانات:
GOOGLE_ANALYTICS_PROPERTY Google Analytics.
FLOODLIGHT_CONFIG إعدادات Floodlight
GOOGLE_AD_MANAGER "مدير إعلانات Google".

PseudonymousIdInfo

معلومات إضافية عندما يكون PSEUDONYMOUS_ID أحد upload_key_types

الحقول
sync_status

SyncStatus

النتائج فقط. حالة مزامنة قائمة المستخدمين.
billable_record_count

int64

اختيارية: غير قابل للتغيير. عدد السجلات القابلة للفوترة (مثل السجلات التي تم تحميلها أو مطابقتها)

SyncStatus

حالة مزامنة قائمة المستخدمين.

عمليات التعداد
SYNC_STATUS_UNSPECIFIED لم يتم تحديد أي قيمة.
CREATED تم إنشاء قائمة المستخدمين كعنصر نائب. لا يزال يتمّ مزامنة محتوى القائمة و/أو البيانات الوصفية. قائمة المستخدمين غير جاهزة للاستخدام.
READY_FOR_USE قائمة المستخدمين جاهزة للاستخدام. تمت مزامنة المحتوى وملفات تعريف الارتباط بشكل صحيح.
FAILED حدث خطأ أثناء مزامنة محتوى و/أو بيانات وصفية لقائمة المستخدمين. لا يمكن استخدام قائمة المستخدمين.

RemoveAllAudienceMembersRequest

طلب إزالة جميع المستخدمين من شريحة جمهور في الوجهات المقدَّمة تعرض RemoveAllAudienceMembersResponse.

يمكنك تجربة هذه الطريقة في مستكشف REST API:
تجربة REST
الحقول
destinations[]

Destination

الحقل مطلوب. قائمة الوجهات التي ستتم إزالة المستخدمين منها
remove_as_of_time

Timestamp

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

bool

اختيارية: لأغراض الاختبار إذا كانت القيمة true، يتم التحقّق من صحة الطلب ولكن لا يتم تنفيذه. يتم عرض الأخطاء فقط، وليس النتائج.

RemoveAllAudienceMembersResponse

ردّ من RemoveAllAudienceMembersRequest

الحقول
request_id

string

المعرّف الذي يتم إنشاؤه تلقائيًا للطلب.

RemoveAudienceMembersRequest

طلب إزالة مستخدمين من شريحة جمهور في الوجهات المقدَّمة تعرض RemoveAudienceMembersResponse.

يمكنك تجربة هذه الطريقة في مستكشف REST API:
تجربة REST
الحقول
destinations[]

Destination

الحقل مطلوب. قائمة الوجهات التي ستتم إزالة المستخدمين منها
audience_members[]

AudienceMember

الحقل مطلوب. قائمة المستخدمين المطلوب إزالتهم
validate_only

bool

اختيارية: لأغراض الاختبار إذا كانت القيمة true، يتم التحقّق من صحة الطلب ولكن لا يتم تنفيذه. يتم عرض الأخطاء فقط، وليس النتائج.
encoding

Encoding

اختيارية: يجب توفيرها لتحميل UserData. نوع الترميز لمعرّفات المستخدمين ينطبق ذلك فقط على الترميز الخارجي لمعرّفات المستخدمين المشفّرة. يتم تجاهل هذا الحقل في عمليات التحميل التي لا تتضمّن UserData.
encryption_info

EncryptionInfo

اختيارية: معلومات التشفير لعمليات تحميل UserData في حال عدم ضبط هذا الخيار، يُفترض أنّ المعلومات التعريفية المحمَّلة مجزّأة ولكنّها غير مشفّرة. يتم تجاهل هذا الحقل في عمليات التحميل التي لا تتضمّن UserData.

RemoveAudienceMembersResponse

ردّ من RemoveAudienceMembersRequest

الحقول
request_id

string

المعرّف الذي يتم إنشاؤه تلقائيًا للطلب.

RemoveUsersRequest

طلب إزالة المستخدمين من الوجهات المقدَّمة

يمكنك تجربة هذه الطريقة في مستكشف واجهات REST API:
تجربة REST
الحقول
destinations[]

Destination

الحقل مطلوب. قائمة بوجهات النقل المحتملة
user_data[]

UserData

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

EncryptionInfo

اختيارية: معلومات التشفير حول مفاتيح التشفير المستخدَمة لتشفير البيانات
validate_only

bool

اختيارية: إذا كانت القيمة true، يتم التحقّق من صحة الطلب ولكن لا يتم تنفيذه.
encoding

Encoding

الحقل مطلوب. نوع الترميز لمعرّفات المستخدمين بالنسبة إلى معرّفات المستخدمين المشفّرة، ينطبق ذلك فقط على الترميز الخارجي.

RemoveUsersResponse

الردّ من RemoveUsersRequest

الحقول
request_id

string

معرّف الطلب الذي تم إنشاؤه لطلب الاستيعاب

RequestStatusPerDestination

حالة الطلب لكل وجهة

الحقول
destination

Destination

وجهة ضمن طلب بيانات من واجهة برمجة تطبيقات الرسائل المباشرة
request_status

RequestStatus

حالة الطلب الخاص بالموقع.
error_info

ErrorInfo

خطأ في معلومات الخطأ يتضمّن سبب الخطأ وعدد الأخطاء المرتبطة بعملية التحميل تتم تعبئة هذا الحقل فقط إذا كانت قيمة request_status هي FAILED أو PARTIAL_SUCCESS. لا تتم تعبئة هذا الحقل عندما يكون الطلب في حالة request_status من PROCESSING.
warning_info

WarningInfo

معلومات تحذيرية تتضمّن سبب التحذير وعدد التحذيرات المرتبطة بعملية التحميل لا تتم تعبئة هذا الحقل عندما يكون الطلب في حالة request_status من PROCESSING.
حقل الربط status تمثّل هذه السمة حالة الوجهة. يمكن أن يكون التعليق status إحدى القيم التالية فقط:
audience_members_ingestion_status

IngestAudienceMembersStatus

حالة طلب استيعاب أعضاء شرائح الجمهور.
events_ingestion_status

IngestEventsStatus

حالة طلب أحداث الاستيعاب.
audience_members_removal_status

RemoveAudienceMembersStatus

حالة طلب إزالة أعضاء الجمهور
remove_all_audience_members_status

RemoveAllAudienceMembersStatus

حالة طلب إزالة جميع أعضاء الجمهور.

DataType

تمثّل هذه السمة نوع البيانات.

عمليات التعداد
DATA_TYPE_UNSPECIFIED نوع البيانات غير محدّد.
EMAIL البيانات هي عنوان بريد إلكتروني.
PHONE_NUMBER البيانات هي رقم هاتف.
ADDRESS البيانات هي عنوان جغرافي.
IP_ADDRESS البيانات هي عنوان IP.

DataTypeCount

عدد نوع بيانات معيّن

الحقول
type

DataType

تمثّل هذه السمة نوع البيانات.
count

int64

تمثّل هذه السمة عدد العناصر من نوع البيانات هذا.

IngestAudienceMembersStatus

حالة طلب استيعاب أعضاء شرائح الجمهور.

الحقول
حقل الربط status حالة نقل بيانات أعضاء الجمهور إلى الوجهة يمكن أن يكون التعليق status إحدى القيم التالية فقط:
user_data_ingestion_status

IngestUserDataStatus

حالة نقل بيانات المستخدم إلى الوجهة
mobile_data_ingestion_status

IngestMobileDataStatus

حالة نقل بيانات الجوّال إلى الوجهة
pair_data_ingestion_status

IngestPairDataStatus

حالة نقل بيانات الزوج إلى الوجهة
user_id_data_ingestion_status

IngestUserIdDataStatus

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

IngestPpidDataStatus

حالة نقل بيانات المعرّف المقدَّم من الناشر إلى الوجهة
composite_data_ingestion_status

IngestCompositeDataStatus

حالة نقل البيانات المجمّعة إلى الوجهة
google_user_id_data_ingestion_status

IngestGoogleUserIdDataStatus

حالة نقل بيانات رقم تعريف مستخدم Google إلى الوجهة.
partner_provided_id_data_ingestion_status

IngestPartnerProvidedIdDataStatus

حالة نقل بيانات أرقام التعريف المقدَّمة من الشريك إلى الوجهة

IngestCompositeDataStatus

حالة نقل البيانات المركّبة إلى الوجهة التي تحتوي على إحصاءات ذات صلة بالنقل.

الحقول
record_count

int64

إجمالي عدد أفراد الجمهور الذين تم إرسالهم في طلب التحميل إلى الوجهة. يتضمّن جميع أفراد الجمهور في الطلب، بغض النظر عمّا إذا تم نقلهم بنجاح أم لا.
data_type_counts[]

DataTypeCount

إجمالي عدد أنواع البيانات المُرسَلة في طلب التحميل إلى الوجهة، مقسَّمة حسب نوع البيانات تتضمّن جميع أنواع البيانات في الطلب، بغض النظر عمّا إذا تم نقلها بنجاح أم لا.
upload_match_rate_range

MatchRateRange

نطاق نسبة المطابقة لعملية التحميل

IngestEventsStatus

تمثّل هذه السمة حالة نقل الأحداث إلى الوجهة.

الحقول
record_count

int64

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

IngestGoogleUserIdDataStatus

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

الحقول
record_count

int64

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

int64

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

IngestMobileDataStatus

حالة نقل بيانات الجوّال إلى الوجهة التي تحتوي على إحصاءات ذات صلة بعملية النقل

الحقول
record_count

int64

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

int64

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

IngestPairDataStatus

حالة نقل بيانات الربط إلى الوجهة التي تحتوي على إحصاءات متعلّقة بالنقل

الحقول
record_count

int64

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

int64

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

IngestPartnerProvidedIdDataStatus

حالة نقل بيانات المعرّف المقدَّم من الشريك إلى الوجهة التي تحتوي على إحصاءات متعلّقة بعملية النقل

الحقول
record_count

int64

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

int64

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

IngestPpidDataStatus

حالة نقل بيانات المعرّف المقدَّم من الناشر إلى الوجهة التي تحتوي على إحصاءات متعلّقة بعملية النقل

الحقول
record_count

int64

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

int64

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

IngestUserDataStatus

حالة نقل بيانات المستخدم إلى الوجهة التي تحتوي على إحصاءات ذات صلة بعملية النقل

الحقول
record_count

int64

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

int64

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

MatchRateRange

نطاق نسبة المطابقة لعملية التحميل

IngestUserIdDataStatus

حالة نقل بيانات رقم تعريف المستخدم إلى الوجهة التي تحتوي على إحصاءات ذات صلة بعملية النقل

الحقول
record_count

int64

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

int64

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

RemoveAllAudienceMembersStatus

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

حالة طلب إزالة جميع أعضاء الجمهور.

RemoveAudienceMembersStatus

حالة طلب إزالة أعضاء الجمهور

الحقول
حقل الربط status حالة إزالة أعضاء الجمهور من الوجهة يمكن أن يكون التعليق status إحدى القيم التالية فقط:
user_data_removal_status

RemoveUserDataStatus

حالة إزالة بيانات المستخدم من الوجهة
mobile_data_removal_status

RemoveMobileDataStatus

حالة إزالة بيانات الجوّال من الوجهة
pair_data_removal_status

RemovePairDataStatus

حالة إزالة بيانات الربط من الوجهة
user_id_data_removal_status

RemoveUserIdDataStatus

حالة إزالة بيانات رقم تعريف المستخدم من الوجهة.
ppid_data_removal_status

RemovePpidDataStatus

حالة إزالة بيانات المعرّف المقدَّم من الناشر من الوجهة
composite_data_removal_status

RemoveCompositeDataStatus

حالة إزالة البيانات المركّبة من الوجهة
google_user_id_data_removal_status

RemoveGoogleUserIdDataStatus

حالة إزالة بيانات رقم تعريف مستخدم Google من الوجهة.
partner_provided_id_data_removal_status

RemovePartnerProvidedIdDataStatus

حالة إزالة بيانات رقم التعريف المقدَّم من الشريك من الوجهة

RemoveCompositeDataStatus

حالة إزالة البيانات المركّبة من الوجهة

الحقول
record_count

int64

إجمالي عدد أفراد شرائح الجمهور المُرسَلين في طلب الإزالة. يتضمّن جميع أفراد الجمهور في الطلب، بغض النظر عمّا إذا تمت إزالتهم بنجاح أم لا.
data_type_counts[]

DataTypeCount

إجمالي عدد أنواع البيانات المُرسَلة في طلب الإزالة، مقسَّمًا حسب نوع البيانات يتضمّن جميع أنواع البيانات في الطلب، بغض النظر عمّا إذا تمت إزالتها بنجاح أم لا.

RemoveGoogleUserIdDataStatus

حالة إزالة بيانات رقم تعريف مستخدم Google من الوجهة.

الحقول
record_count

int64

إجمالي عدد أفراد شرائح الجمهور المُرسَلين في طلب الإزالة. يتضمّن جميع أفراد الجمهور في الطلب، بغض النظر عمّا إذا تمت إزالتهم بنجاح أم لا.
google_user_id_count

int64

إجمالي عدد معرّفات مستخدمي Google المُرسَلة في طلب الإزالة. يتضمّن جميع أرقام تعريف مستخدمي Google في الطلب، بغض النظر عمّا إذا تمت إزالتها بنجاح أم لا.

RemoveMobileDataStatus

حالة إزالة بيانات الجوّال من الوجهة

الحقول
record_count

int64

إجمالي عدد أفراد شرائح الجمهور المُرسَلين في طلب الإزالة. يتضمّن جميع أفراد الجمهور في الطلب، بغض النظر عمّا إذا تمت إزالتهم بنجاح أم لا.
mobile_id_count

int64

تمثّل هذه السمة العدد الإجمالي لمعرّفات الأجهزة الجوّالة المُرسَلة في طلب الإزالة. تتضمّن جميع أرقام التعريف على الأجهزة الجوّالة في الطلب، بغض النظر عمّا إذا تمت إزالتها بنجاح أم لا.

RemovePairDataStatus

حالة إزالة بيانات الربط من الوجهة

الحقول
record_count

int64

إجمالي عدد أفراد شرائح الجمهور المُرسَلين في طلب الإزالة. يتضمّن جميع أفراد الجمهور في الطلب، بغض النظر عمّا إذا تمت إزالتهم بنجاح أم لا.
pair_id_count

int64

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

RemovePartnerProvidedIdDataStatus

حالة إزالة بيانات رقم التعريف المقدَّم من الشريك من الوجهة

الحقول
record_count

int64

إجمالي عدد أفراد شرائح الجمهور المُرسَلين في طلب الإزالة. يتضمّن جميع أفراد الجمهور في الطلب، بغض النظر عمّا إذا تمت إزالتهم بنجاح أم لا.
partner_provided_id_count

int64

إجمالي عدد المعرّفات المقدَّمة من الشريك والتي تم إرسالها في طلب الإزالة يتضمّن هذا الحقل جميع المعرّفات التي يقدّمها الشريك في الطلب، بغض النظر عمّا إذا تمت إزالتها بنجاح أم لا.

RemovePpidDataStatus

حالة إزالة بيانات المعرّف المقدَّم من الناشر من الوجهة

الحقول
record_count

int64

إجمالي عدد أفراد شرائح الجمهور المُرسَلين في طلب الإزالة. يتضمّن جميع أفراد الجمهور في الطلب، بغض النظر عمّا إذا تمت إزالتهم بنجاح أم لا.
ppid_count

int64

تمثّل هذه السمة إجمالي عدد المعرّفات المقدَّمة من الناشر التي تم إرسالها في طلب الإزالة. يتضمّن جميع المعرّفات المقدَّمة من الناشر في الطلب، بغض النظر عمّا إذا تمت إزالتها بنجاح أم لا.

RemoveUserDataStatus

حالة إزالة بيانات المستخدم من الوجهة

الحقول
record_count

int64

إجمالي عدد أفراد شرائح الجمهور المُرسَلين في طلب الإزالة. يتضمّن جميع أفراد الجمهور في الطلب، بغض النظر عمّا إذا تمت إزالتهم بنجاح أم لا.
user_identifier_count

int64

إجمالي عدد معرّفات المستخدمين المُرسَلة في طلب الإزالة. يتضمّن جميع معرّفات المستخدمين في الطلب، بغض النظر عمّا إذا تمت إزالتها بنجاح أم لا.

RemoveUserIdDataStatus

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

الحقول
record_count

int64

إجمالي عدد أفراد شرائح الجمهور المُرسَلين في طلب الإزالة. يتضمّن جميع أفراد الجمهور في الطلب، بغض النظر عمّا إذا تمت إزالتهم بنجاح أم لا.
user_id_count

int64

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

RequestStatus

حالة الطلب

عمليات التعداد
REQUEST_STATUS_UNKNOWN حالة الطلب غير معروفة.
SUCCESS تمت معالجة جميع السجلات بنجاح بدون أي أخطاء. ومع ذلك، قد تظهر تحذيرات في الحقل warning_info.
PROCESSING جارٍ معالجة الطلب.
FAILED تعذّرت معالجة جميع السجلات. راجِع الحقل error_info للاطّلاع على تفاصيل الخطأ، والحقل warning_info للاطّلاع على تفاصيل التحذير.
PARTIAL_SUCCESS تمت المعالجة بنجاح بدون أخطاء لبعض السجلات، ولكن تعذّر إتمامها مع ظهور أخطاء لسجلات أخرى. راجِع الحقل error_info للاطّلاع على تفاصيل الخطأ، والحقل warning_info للاطّلاع على تفاصيل التحذير.

RetrieveInsightsRequest

رسالة الطلب الخاصة بـ DM API MarketingDataInsightsService.RetrieveInsights

يمكنك تجربة هذه الطريقة في مستكشف REST API:
تجربة REST
الحقول
parent

string

الحقل مطلوب. حساب الأهل الذي يملك قائمة المستخدمين. التنسيق: accountTypes/{account_type}/accounts/{account}
baseline

Baseline

الحقل مطلوب. تمثّل هذه السمة خط الأساس للرؤى المطلوبة.
user_list_id

string

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

RetrieveInsightsResponse

رسالة الردّ على DM API MarketingDataInsightsService.RetrieveInsights

الحقول
marketing_data_insights[]

MarketingDataInsight

يحتوي على إحصاءات بيانات التسويق.

MarketingDataInsight

إحصاءات حول بيانات التسويق

لا تتوفّر هذه الميزة إلا لشركاء البيانات.

الحقول
dimension

AudienceInsightsDimension

تمثّل هذه السمة السمة التي تنتمي إليها الإحصاءات.
attributes[]

MarketingDataInsightsAttribute

إحصاءات حول قيم سمة معيّنة

AudienceInsightsDimension

السمات المحتملة التي يمكن استخدامها لإنشاء الإحصاءات

عمليات التعداد
AUDIENCE_INSIGHTS_DIMENSION_UNSPECIFIED لم يتم تحديد أي قيمة.
AUDIENCE_INSIGHTS_DIMENSION_UNKNOWN القيمة غير معروفة في هذا الإصدار.
AFFINITY_USER_INTEREST تمثّل هذه السمة اهتمام المستخدمين المشترك.
IN_MARKET_USER_INTEREST تمثّل هذه السمة اهتمام المستخدمين في السوق.
AGE_RANGE تمثّل هذه السمة فئة عمرية.
GENDER جنس

MarketingDataInsightsAttribute

إحصاءات لمجموعة من السمات ذات الصلة من السمة نفسها

الحقول
user_interest_id

int64

رقم تعريف اهتمام المستخدِم.
lift

float

مقياس التحسّن الذي حقّقه الجمهور في قيمة السمة مقارنةً بالمقياس الأساسي. النطاق [0-1].
age_range

AgeRange

الفئة العمرية للجمهور الذي يتم توفير التحسّن له.
gender

Gender

جنس الجمهور الذي يتم توفير مقياس التحسّن له.

RetrieveRequestStatusRequest

طلب الحصول على حالة الطلب المقدَّم إلى واجهة برمجة تطبيقات "إدارة الأجهزة الجوّالة" (DM) لرقم تعريف طلب معيّن تعرض RetrieveRequestStatusResponse.

يمكنك تجربة هذه الطريقة في مستكشف واجهات REST API:
تجربة REST
الحقول
request_id

string

الحقل مطلوب. الحقل مطلوب. معرّف طلب بيانات من واجهة برمجة التطبيقات لـ Data Manager API

RetrieveRequestStatusResponse

ردّ من RetrieveRequestStatusRequest

الحقول
request_status_per_destination[]

RequestStatusPerDestination

قائمة بحالات الطلبات لكل وجهة. يتطابق ترتيب الحالات مع ترتيب وجهات الطلب الأصلي.

SearchPartnerLinksRequest

طلب البحث عن مراجع PartnerLink تعرض SearchPartnerLinksResponse.

يمكنك تجربة هذه الطريقة في مستكشف واجهات REST API:
تجربة REST
الحقول
parent

string

الحقل مطلوب. الحساب الذي سيتم البحث فيه عن روابط الشركاء في حال عدم تحديد filter، يتم عرض جميع روابط الشركاء التي يكون فيها هذا الحساب إما owning_account أو partner_account.

التنسيق: accountTypes/{account_type}/accounts/{account}
page_size

int32

الحدّ الأقصى لعدد روابط الشركاء التي سيتم عرضها. قد تعرض الخدمة عددًا أقل من هذه القيمة. إذا لم يتم تحديدها، سيتم عرض 50 رابطًا للشركاء كحدّ أقصى. الحدّ الأقصى للقيمة هو 100، وسيتم تحويل القيم التي تزيد عن 100 إلى 100.
page_token

string

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

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

string

اختيارية: سلسلة فلترة يجب أن تكون جميع الحقول على الجانب الأيمن من كل شرط (على سبيل المثال: partner_link_id = 123456789). يجب تحديد الحقول باستخدام camel case أو snake case. لا تستخدِم مزيجًا من تنسيق Camel Case وتنسيق Snake Case.

العمليات المتوافقة:

  • AND
  • =
  • !=

الحقول المتوافقة:

  • partner_link_id
  • owning_account.account_type
  • owning_account.account_id
  • partner_account.account_type
  • partner_account.account_id
  • feature_set

بالنسبة إلى روابط الشركاء التي تتضمّن مجموعة الخصائص FEATURE_SET_AD_EVENT_MANAGEMENT، تتوفّر الحقول التالية أيضًا:

  • partner_customer_account.account_id
  • partner_link_metadata.implicit_accounts.account_id

مثلاً: owning_account.account_type = "GOOGLE_ADS" AND partner_account.account_id = 987654321

SearchPartnerLinksResponse

ردّ من SearchPartnerLinksRequest

الحقول
next_page_token

string

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

SizeInfo

عدد الأعضاء المقدَّر في قائمة المستخدمين هذه على الشبكات المستهدَفة المختلفة

الحقول
display_network_members_count

int64

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

int64

النتائج فقط. عدد الأعضاء المقدَّر في قائمة المستخدمين هذه ضمن النطاق google.com. هذه هي شرائح الجمهور المتاحة للاستهداف في "الحملات على شبكة البحث".
youtube_members_count

int64

النتائج فقط. العدد المقدَّر للأعضاء في قائمة المستخدمين هذه على YouTube
gmail_members_count

int64

النتائج فقط. العدد المقدَّر للأعضاء في قائمة المستخدمين هذه على Gmail

TargetNetworkInfo

معلومات الأهلية للشبكات المستهدَفة المختلفة

الحقول
eligible_for_display

bool

النتائج فقط. تشير إلى أنّ قائمة المستخدمين هذه مؤهَّلة لشبكة Google الإعلانية.

TargetingType

نوع الاستهداف المستخدَم لعرض الإعلان.

عمليات التعداد
TARGETING_TYPE_UNSPECIFIED نوع استهداف غير محدَّد
TARGETING_TYPE_AUDIENCE استهداف الجمهور
TARGETING_TYPE_CONTEXTUAL استهداف المحتوى:
TARGETING_TYPE_DEMOGRAPHIC استهداف الفئات الديمغرافية
TARGETING_TYPE_DEVICE استهداف الأجهزة
TARGETING_TYPE_GEO الاستهداف الجغرافي
TARGETING_TYPE_INTEREST استهداف الاهتمامات
TARGETING_TYPE_PURCHASE_INTENT استهداف الرغبة في الشراء
TARGETING_TYPE_REMARKETING استهداف تجديد النشاط التسويقي

TermsOfService

بنود الخدمة التي قبلها المستخدم أو رفضها.

الحقول
customer_match_terms_of_service_status

TermsOfServiceStatus

اختيارية: بنود خدمة "مطابقة العملاء": https://support.google.com/adspolicy/answer/6299717 يجب قبول ذلك عند استيعاب UserData أو MobileData. هذا الحقل غير مطلوب لقائمة مستخدمي ميزة "مطابقة الشركاء".

TermsOfServiceStatus

تمثّل هذه السمة قرار المتصل بقبول بنود الخدمة أو رفضها.

عمليات التعداد
TERMS_OF_SERVICE_STATUS_UNSPECIFIED لم يتم تحديد أي قيمة.
ACCEPTED حالة تشير إلى أنّ المتصل اختار قبول بنود الخدمة.
REJECTED الحالة التي تشير إلى أنّ المتصل اختار رفض بنود الخدمة.

UpdateUserListDirectLicenseRequest

طلب تعديل مرجع UserListDirectLicense

يمكنك تجربة هذه الطريقة في مستكشف REST API:
تجربة REST
الحقول
user_list_direct_license

UserListDirectLicense

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

FieldMask

اختيارية: قائمة الحقول التي سيتم تعديلها. الرمز الخاص * غير متاح وسيظهر الخطأ INVALID_UPDATE_MASK في حال استخدامه.

UpdateUserListGlobalLicenseRequest

طلب تعديل مرجع UserListGlobalLicense

يمكنك تجربة هذه الطريقة في مستكشف واجهات REST API:
تجربة REST
الحقول
user_list_global_license

UserListGlobalLicense

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

FieldMask

اختيارية: قائمة الحقول التي سيتم تعديلها. الرمز الخاص * غير متاح وسيظهر الخطأ INVALID_UPDATE_MASK في حال استخدامه.

UpdateUserListRequest

رسالة الطلب الخاصة بـ UpdateUserList

يمكنك تجربة هذه الطريقة في مستكشف واجهات REST API:
تجربة REST
الحقول
user_list

UserList

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

يُستخدَم حقل name في قائمة المستخدمين لتحديد قائمة المستخدمين المطلوب تعديلها. التنسيق: accountTypes/{account_type}/accounts/{account}/userLists/{user_list}
update_mask

FieldMask

اختيارية: قائمة الحقول التي سيتم تعديلها.
validate_only

bool

اختيارية: إذا كانت القيمة صحيحة، يتم التحقّق من صحة الطلب ولكن لا يتم تنفيذه.

المستخدم

يمثّل مستخدمًا واحدًا، ويحتوي على معرّفات مثل معلومات تكشف الهوية الشخصية وأرقام تعريف الأجهزة الجوّالة التي تشير جميعها إلى المستخدم نفسه.

الحقول
user_data

UserData

الحقل مطلوب. أجزاء متعدّدة من البيانات المقدَّمة من المستخدِم، وتُستخدَم كوسيلة لتحديد هوية المستخدِم
mobile_data

MobileData

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

UserData

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

الحقول
user_identifiers[]

UserIdentifier

الحقل مطلوب. معرّفات المستخدم يمكن تقديم عدة أمثلة على النوع نفسه من البيانات (مثل عناوين بريد إلكتروني متعددة). لزيادة احتمال حدوث تطابق، قدِّم أكبر عدد ممكن من المعرّفات. يمكن تقديم 10 userIdentifiers كحد أقصى في AudienceMember أو Event واحد.

UserIdData

بيانات رقم تعريف المستخدم التي تتضمّن رقم تعريف المستخدم

الحقول
user_id

string

الحقل مطلوب. معرّف فريد للمستخدِم، كما يحدّده المعلِن.

UserIdInfo

معلومات إضافية عندما يكون USER_ID أحد upload_key_types

الحقول
data_source_type

DataSourceType

اختيارية: غير قابل للتغيير. تمثّل هذه السمة مصدر بيانات التحميل.

UserIdentifier

معرّف واحد للمستخدم

الحقول
حقل الربط identifier يجب تحديد قيمة واحدة بالضبط. يمكن أن يكون التعليق identifier إحدى القيم التالية فقط:
email_address

string

عنوان بريد إلكتروني مجزّأ باستخدام دالة التجزئة SHA-256 بعد التسوية
phone_number

string

رقم الهاتف المجزّأ باستخدام دالة التجزئة SHA-256 بعد التسوية (معيار E164)
address

AddressInfo

العناصر المعروفة لعنوان المستخدم تحتوي على مجموعة من المعرّفات التي تتم مطابقتها كلها في وقت واحد.

UserList

أحد موارد قوائم المستخدمين.

الحقول
name

string

المعرّف. اسم المورد لقائمة المستخدمين. التنسيق: accountTypes/{account_type}/accounts/{account}/userLists/{user_list}
id

int64

النتائج فقط. المعرّف الفريد لقائمة المستخدِمين.
read_only

bool

النتائج فقط. خيار يشير إلى ما إذا كان بإمكان المستخدم تعديل قائمة.
membership_duration

Duration

اختيارية: هي المدة التي يبقى فيها المستخدم في قائمة المستخدمين. المدد الصالحة هي مضاعفات دقيقة لـ 24 ساعة (86400 ثانية). سيؤدي تقديم قيمة ليست مضاعفًا دقيقًا لـ 24 ساعة إلى حدوث خطأ INVALID_ARGUMENT.
access_reason

AccessReason

النتائج فقط. سبب منح هذا الحساب إذن الوصول إلى القائمة
size_info

SizeInfo

النتائج فقط. عدد الأعضاء المقدَّر في قائمة المستخدمين هذه على الشبكات المستهدَفة المختلفة
target_network_info

TargetNetworkInfo

اختيارية: معلومات الأهلية للشبكات المستهدَفة المختلفة
display_name

string

الحقل مطلوب. الاسم المعروض لقائمة المستخدمين
description

string

اختيارية: تمثّل هذه السمة وصفًا لقائمة المستخدمين.
membership_status

MembershipStatus

اختيارية: حالة العضوية في قائمة المستخدمين هذه.
integration_code

string

اختيارية: معرّف من نظام خارجي يستخدمها بائعو قوائم المستخدِمين لربط المعرّفات في أنظمتهم.
closing_reason

ClosingReason

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

AccessStatus

اختيارية: تشير إلى ما إذا كانت هذه المشاركة لا تزال مفعَّلة. عند مشاركة قائمة مستخدمين مع الحساب الذي تم ضبط هذا الحقل على ENABLED يمكن لمالك قائمة المستخدمين في وقت لاحق إلغاء المشاركة وجعلها DISABLED.
حقل الربط user_list_info معلومات إضافية عن قائمة المستخدمين يمكن أن يكون التعليق user_list_info إحدى القيم التالية فقط:
ingested_user_list_info

IngestedUserListInfo

اختيارية: تمثّل هذه السمة قائمة مستخدمين يتمّ ملؤها ببيانات المستخدمين التي تمّت معالجتها.

AccessReason

تعداد يصف أسباب الوصول المحتملة.

عمليات التعداد
ACCESS_REASON_UNSPECIFIED لم يتم تحديد أي قيمة.
OWNED يمتلك المستخدم المورد.
SHARED تتم مشاركة المرجع مع المستخدم.
LICENSED تم ترخيص المورد للمستخدم.
SUBSCRIBED اشترك المستخدم في المرجع.
AFFILIATED يمكن للمستخدم الوصول إلى المورد.

AccessStatus

توضّح ما إذا كان بإمكان هذا العميل الوصول إلى القائمة.

عمليات التعداد
ACCESS_STATUS_UNSPECIFIED لم يتم تحديد أي قيمة.
ENABLED تم تفعيل إمكانية الوصول.
DISABLED تم إيقاف إذن الوصول.

ClosingReason

تشير إلى سبب إغلاق قائمة المستخدمين. لا يتم استخدام هذه القائمة إلا عندما يغلق النظام القائمة تلقائيًا.

عمليات التعداد
CLOSING_REASON_UNSPECIFIED لم يتم تحديد أي قيمة.
UNUSED تم إغلاق قائمة المستخدِمين لأنّه لم يتم استخدامها في الاستهداف مؤخرًا. لمزيد من التفاصيل، يُرجى الانتقال إلى https://support.google.com/google-ads/answer/2472738.

MembershipStatus

حالة قائمة المستخدمين.

عمليات التعداد
MEMBERSHIP_STATUS_UNSPECIFIED لم يتم تحديد أي قيمة.
OPEN الحالة "مفتوحة": يتم إضافة مستخدمين إلى قائمة المستخدمين ويمكن استهدافها.
CLOSED الحالة "مغلقة": لا تتم إضافة أعضاء جدد.

UserListDirectLicense

ترخيص مباشر لقائمة مستخدمين

لا تتوفّر هذه الميزة إلا لشركاء البيانات.

الحقول
name

string

المعرّف. اسم المورد لترخيص قائمة المستخدمين المباشر.
user_list_display_name

string

النتائج فقط. اسم قائمة المستخدمين التي يتم ترخيصها

هذا الحقل مخصّص للقراءة فقط.
client_account_display_name

string

النتائج فقط. اسم عميل العميل الذي يتم ترخيص قائمة المستخدمين له.

هذا الحقل مخصّص للقراءة فقط.
pricing

UserListLicensePricing

اختيارية: أسعار UserListDirectLicense
historical_pricings[]

UserListLicensePricing

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

هذا الحقل مخصّص للقراءة فقط.
metrics

UserListLicenseMetrics

النتائج فقط. المقاييس ذات الصلة بهذا الترخيص

هذا الحقل للقراءة فقط ولا تتم تعبئته إلا إذا تم ضبط تاريخَي البدء والانتهاء في طلب ListUserListDirectLicenses.
user_list_id

int64

غير قابل للتغيير. معرّف قائمة المستخدمين التي يتم ترخيصها.
client_account_type

UserListLicenseClientAccountType

غير قابل للتغيير. نوع حساب عميل العميل الذي يتم ترخيص قائمة المستخدمين له.
client_account_id

int64

غير قابل للتغيير. رقم تعريف عميل الحساب الذي يتم ترخيص قائمة المستخدمين له.
status

UserListLicenseStatus

اختيارية: حالة UserListDirectLicense - ENABLED أو DISABLED

UserListGlobalLicense

ترخيص عالمي لقائمة مستخدمين

لا تتوفّر هذه الميزة إلا لشركاء البيانات.

الحقول
name

string

المعرّف. اسم المورد لترخيص قائمة المستخدمين على مستوى العالم.
user_list_display_name

string

النتائج فقط. اسم قائمة المستخدمين التي يتم ترخيصها

هذا الحقل مخصّص للقراءة فقط.
pricing

UserListLicensePricing

اختيارية: أسعار ترخيص UserListGlobalLicense
historical_pricings[]

UserListLicensePricing

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

هذا الحقل مخصّص للقراءة فقط.
metrics

UserListLicenseMetrics

النتائج فقط. المقاييس ذات الصلة بهذا الترخيص

هذا الحقل للقراءة فقط ولا تتم تعبئته إلا إذا تم ضبط تاريخَي البدء والانتهاء في طلب ListUserListGlobalLicenses.
user_list_id

int64

غير قابل للتغيير. معرّف قائمة المستخدمين التي يتم ترخيصها.
license_type

UserListGlobalLicenseType

غير قابل للتغيير. نوع منتج عميل العميل الذي يتم ترخيص قائمة المستخدمين له.
status

UserListLicenseStatus

اختيارية: حالة UserListGlobalLicense - ENABLED أو DISABLED

UserListGlobalLicenseCustomerInfo

معلومات حول أحد العملاء الذين لديهم ترخيص عالمي لقائمة مستخدمين سيتم إنشاء هذا المعرّف تلقائيًا بواسطة النظام عندما يشتري العميل ترخيصًا عالميًا.

الحقول
name

string

المعرّف. اسم المورِد الخاص بالعميل الذي لديه ترخيص عالمي لقائمة المستخدِمين.
user_list_id

int64

النتائج فقط. معرّف قائمة المستخدمين التي يتم ترخيصها.
user_list_display_name

string

النتائج فقط. اسم قائمة المستخدمين التي يتم ترخيصها
license_type

UserListGlobalLicenseType

النتائج فقط. نوع منتج عميل العميل الذي يتم ترخيص قائمة المستخدمين له.
status

UserListLicenseStatus

النتائج فقط. حالة UserListDirectLicense - ENABLED أو DISABLED
pricing

UserListLicensePricing

النتائج فقط. أسعار UserListDirectLicense
client_account_type

UserListLicenseClientAccountType

النتائج فقط. نوع منتج عميل العميل الذي يتم ترخيص قائمة المستخدمين له.
client_account_id

int64

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

string

النتائج فقط. اسم عميل العميل الذي يتم ترخيص قائمة المستخدمين له.
historical_pricings[]

UserListLicensePricing

النتائج فقط. سجلّ أسعار ترخيص قائمة المستخدمين هذه
metrics

UserListLicenseMetrics

النتائج فقط. المقاييس ذات الصلة بهذا الترخيص

لا تتم تعبئة هذا الحقل إلا إذا تم ضبط تاريخَي البدء والانتهاء في طلب ListUserListGlobalLicenseCustomerInfos.

UserListGlobalLicenseType

أنواع التراخيص العالمية لقوائم المستخدمين

عمليات التعداد
USER_LIST_GLOBAL_LICENSE_TYPE_UNSPECIFIED UNSPECIFIED.
USER_LIST_GLOBAL_LICENSE_TYPE_RESELLER ترخيص المورِّد
USER_LIST_GLOBAL_LICENSE_TYPE_DATA_MART_SELL_SIDE ترخيص DataMart Sell Side
USER_LIST_GLOBAL_LICENSE_TYPE_DATA_MART_BUY_SIDE ترخيص DataMart Buy Side

UserListLicenseClientAccountType

المنتج المحتمل لحساب عميل لترخيص قائمة مستخدمين

عمليات التعداد
USER_LIST_LICENSE_CLIENT_ACCOUNT_TYPE_UNKNOWN غير معروف.
USER_LIST_LICENSE_CLIENT_ACCOUNT_TYPE_GOOGLE_ADS عميل "إعلانات Google"
USER_LIST_LICENSE_CLIENT_ACCOUNT_TYPE_DISPLAY_VIDEO_PARTNER شريك "مساحة العرض والفيديو 360"
USER_LIST_LICENSE_CLIENT_ACCOUNT_TYPE_DISPLAY_VIDEO_ADVERTISER مُعلِن على "مساحة العرض والفيديو 360"

UserListLicenseMetrics

مقاييس ذات صلة بترخيص قائمة مستخدمين

الحقول
click_count

int64

النتائج فقط. عدد النقرات على ترخيص قائمة المستخدِمين.
impression_count

int64

النتائج فقط. عدد مرّات الظهور لترخيص قائمة المستخدِمين
revenue_usd_micros

int64

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

int64

النتائج فقط. تمثّل هذه السمة تاريخ بدء المقاييس (شاملةً) بالتنسيق YYYYMMDD. على سبيل المثال، يشير الرقم 20260102 إلى 2 يناير 2026. في حال استخدام end_date في الفلتر، يجب أيضًا استخدام start_date. إذا لم يتم تضمين start_date أو end_date في الفلتر، لن تتم تعبئة حقول UserListLicenseMetrics في الردّ.
end_date

int64

النتائج فقط. تاريخ انتهاء المقاييس (شامل) بالتنسيق YYYYMMDD على سبيل المثال، يشير الرقم 20260102 إلى 2 يناير 2026. في حال استخدام start_date في الفلتر، يجب أيضًا استخدام end_date. إذا لم يتم تضمين start_date أو end_date في الفلتر، لن تتم تعبئة حقول UserListLicenseMetrics في الردّ.

UserListLicensePricing

أسعار تراخيص قوائم المستخدمين

الحقول
pricing_id

int64

النتائج فقط. تمثّل هذه السمة معرّف السعر.
start_time

Timestamp

النتائج فقط. تمثّل هذه السمة وقت بدء تطبيق السعر.
end_time

Timestamp

اختيارية: تمثّل هذه السمة وقت انتهاء السعر.
pricing_active

bool

النتائج فقط. تُستخدَم لتحديد ما إذا كان هذا السعر نشطًا.
buyer_approval_state

UserListPricingBuyerApprovalState

النتائج فقط. حالة الموافقة من المشتري على هذا السعر

هذا الحقل مخصّص للقراءة فقط.
cost_micros

int64

اختيارية: تمثّل هذه السمة التكلفة المرتبطة بالنموذج بوحدات ميكرو (10^-6) بالعملة المحدّدة في الحقل currency_code. على سبيل المثال، يعني الرقم 2000000 دولارَين أمريكيَين إذا كانت قيمة currency_code هي USD.
currency_code

string

اختيارية: العملة التي يتم تحديد cost وmax_cost بها. يجب أن يكون رمز عملة مكوّنًا من ثلاثة أحرف ومحدّدًا في معيار ISO 4217.
cost_type

UserListPricingCostType

غير قابل للتغيير. تمثّل هذه السمة نوع التكلفة لهذا السعر.

يمكن ضبطها فقط في عملية create. لا يمكن تعديلها لترخيص حالي.
max_cost_micros

int64

اختيارية: الحدّ الأقصى للتكلفة لكلّ ألف ظهور التي يمكن تحصيلها من جمهور التجارة عند استخدام نوع التكلفة MEDIA_SHARE القيمة بوحدات ميكرو (10^-6) وبالعملة المحدّدة في الحقل currency_code. على سبيل المثال، يعني الرقم 2000000 دولارَين أمريكيَين إذا كانت قيمة currency_code هي USD.

لا تكون هذه السمة ذات صلة إلا عندما تكون قيمة cost_type هي MEDIA_SHARE. عندما لا يكون cost_type هو MEDIA_SHARE ويتم ضبط هذا الحقل، سيتم عرض الخطأ MAX_COST_NOT_ALLOWED. في حال عدم ضبط السياسة أو ضبطها على0، لن يكون هناك حد أقصى.

UserListPricingBuyerApprovalState

حالة الموافقة على المشتري في ما يتعلّق بأسعار قوائم المستخدمين

عمليات التعداد
USER_LIST_PRICING_BUYER_APPROVAL_STATE_UNSPECIFIED UNSPECIFIED.
PENDING لم يقبل عميل قائمة المستخدمين بعد بنود الأسعار التي حدّدها مالك قائمة المستخدمين.
APPROVED قبل عميل قائمة المستخدمين بنود الأسعار التي حدّدها مالك قائمة المستخدمين.
REJECTED رفض عميل قائمة المستخدمين بنود الأسعار التي حدّدها مالك قائمة المستخدمين.

UserListPricingCostType

نوع تكلفة تسعير قائمة المستخدمين:

عمليات التعداد
USER_LIST_PRICING_COST_TYPE_UNSPECIFIED غير محدد
CPC تكلفة النقرة
CPM التكلفة لكل ألف ظهور
MEDIA_SHARE مشاركة الوسائط

UserListLicenseStatus

حالة ترخيص قائمة المستخدمين

عمليات التعداد
USER_LIST_LICENSE_STATUS_UNSPECIFIED غير معروف.
USER_LIST_LICENSE_STATUS_ENABLED الحالة "نشطة": لا يزال يتم منح ترخيص لقائمة المستخدمين.
USER_LIST_LICENSE_STATUS_DISABLED الحالة غير نشطة: لم يعُد يتم ترخيص قائمة المستخدمين.

UserProperties

معلومات يقدّمها المعلِن عن المستخدِم في وقت وقوع الحدث. يمكنك الاطّلاع على https://support.google.com/google-ads/answer/14007601 لمزيد من التفاصيل.

الحقول
customer_type

CustomerType

اختيارية: نوع العميل المرتبط بالحدث.
customer_value_bucket

CustomerValueBucket

اختيارية: القيمة التي يحدّدها المعلِن للعميل.
additional_user_properties[]

UserProperty

اختيارية: مجموعة من أي خصائص مستخدم إضافية للمستخدم المرتبط بهذا الحدث

UserProperty

مجموعة من أي خصائص مستخدم إضافية للمستخدم المرتبط بهذا الحدث

الحقول
property_name

string

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

string

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

ViewType

تمثّل هذه السمة نوع الحدث.

عمليات التعداد
VIEW_TYPE_UNSPECIFIED نوع العرض غير محدَّد.
VIEW_TYPE_MRC_VIEWED تمت مشاهدة MRC.
VIEW_TYPE_MRC_RENDERED تم عرض MRC.

ViewabilityInfo

تفاصيل حول إمكانية عرض الإعلان المعروض

الحقول
view_type

ViewType

الحقل مطلوب. تمثّل هذه السمة نوع الحدث.
viewable_percent

int32

اختيارية: النسبة المئوية الرقمية (من 0 إلى 100) لوحدات البكسل التي كانت قابلة للعرض.
viewable_duration

Duration

اختيارية: مقدار الوقت الذي كان فيه الإعلان قابلاً للعرض
media_skippable

bool

اختيارية: تُستخدَم لتحديد ما إذا كانت وسائط الإعلان قابلة للتخطّي أم لا.
media_quartile

MediaQuartile

اختيارية: تمثّل هذه السمة مقدار الوسائط التي تم تشغيلها كشرائح ربعية منفصلة.
media_duration

Duration

اختيارية: مدة وسائط الإعلان
media_volume_percent

int32

اختيارية: النسبة المئوية العددية (من 0 إلى 100) لمستوى صوت تشغيل الوسائط
playback_duration

Duration

اختيارية: مدة تشغيل وسائط الإعلان، بغض النظر عمّا إذا كان الإعلان قابلاً للعرض أم لا

WarningCount

عدد التحذيرات لسبب تحذير معيّن

الحقول
record_count

int64

عدد السجلات التي تتضمّن تحذيرًا
reason

ProcessingWarningReason

سبب التحذير

WarningInfo

عدد التحذيرات لكل نوع من أنواع التحذيرات

الحقول
warning_counts[]

WarningCount

قائمة بالتحذيرات وعددها لكل سبب تحذير

WarningReason

أسباب ظهور تحذيرات غير حظر أثناء عملية الاستيعاب

عمليات التعداد
WARNING_REASON_UNSPECIFIED سبب التحذير غير محدّد.
WARNING_REASON_CUSTOM_VARIABLE_NOT_ENABLED لم يتم تفعيل متغيّر مخصّص في custom_variables في الحساب.
WARNING_REASON_CUSTOM_VARIABLE_NOT_PREDEFINED قيمة المتغيّر المخصّص في custom_variables ليست من بين القيم المسموح بها المحدّدة مسبقًا والتي تم ضبطها للمتغيّر المخصّص في حساب الوجهة.
WARNING_REASON_CART_DATA_NOT_SUPPORTED_WITH_GBRAID_OR_WBRAID لا تتوافق cart_data مع gbraid أو wbraid.
WARNING_REASON_CART_DATA_ITEM_MERCHANT_PRODUCT_ID_MISSING merchant_product_id غير متوفّر في سلعة سلة التسوّق.
WARNING_REASON_CART_DATA_ITEM_UNIT_PRICE_MISSING unit_price غير متوفّر في سلعة سلة التسوّق.
WARNING_REASON_GENERIC سبب تحذير عام للمشاكل التي لا تندرج ضمن فئات محدّدة أخرى
WARNING_REASON_INVALID_CLIENT_ID client_id غير صالح.
WARNING_REASON_INVALID_SUBDIVISION_CODE subdivision_code غير صالح.
WARNING_REASON_INVALID_REGION_CODE region_code غير صالح.
WARNING_REASON_INVALID_SUBCONTINENT_CODE subcontinent_code غير صالح.
WARNING_REASON_INVALID_CONTINENT_CODE continent_code غير صالح.
WARNING_REASON_INVALID_DEVICE_CATEGORY الجهاز category غير صالح.
WARNING_REASON_INVALID_DEVICE_SCREEN_RESOLUTION الجهاز screen_height أو screen_width غير صالح.
WARNING_REASON_INVALID_MERCHANT_ID merchant_id غير صالح.