Package google.ads.datamanager.v1

الفهرس

IngestionService

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

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
RemoveAudienceMembers

rpc RemoveAudienceMembers(RemoveAudienceMembersRequest) returns (RemoveAudienceMembersResponse)

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

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

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

تحذف هذه الطريقة UserList.

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

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

  • ‫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

AdIdentifiers

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

الحقول
session_attributes

string

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

string

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

string

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

string

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

DeviceInfo

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

AddressInfo

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

الحقول
given_name

string

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

string

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

string

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

string

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

معدل العمر

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

عمليات التعداد
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 عامًا وما فوق

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

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

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

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

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

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

الموقع الجغرافي الأساسي للطلب يجب أن يكون الموقع الجغرافي الأساسي ضمن قائمة OR لرموز المناطق ذات التنسيق 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

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

إعدادات الموافقة بموجب قانون الأسواق الرقمية (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

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

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".

DeviceInfo

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

الحقول
user_agent

string

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

string

اختياريّ. عنوان IP للجهاز في السياق المحدّد

ملاحظة:لا تتيح "إعلانات Google" مطابقة عناوين IP للمستخدِمين النهائيين في المنطقة الاقتصادية الأوروبية أو المملكة المتحدة أو سويسرا. أضِف منطقًا لاستبعاد مشاركة عناوين IP من المستخدِمين في هذه المناطق بشكلٍ مشروط، وتأكَّد من تزويد المستخدِمين بمعلومات واضحة وشاملة حول البيانات التي تجمعها على مواقعك الإلكترونية وتطبيقاتك والمواقع الأخرى، والحصول على موافقتهم حيثما يقتضي القانون أو أي سياسات سارية من Google. اطّلِع على صفحة لمحة عن عمليات استيراد الإحالات الناجحة غير الإلكترونية لمزيد من التفاصيل.

الترميز

نوع الترميز للمعلومات التعريفية المجزأة

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

EncryptionInfo

معلومات التشفير الخاصة بالبيانات التي يتم استيعابها

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

GcpWrappedKeyInfo

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

AwsWrappedKeyInfo

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

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 رمز البلد غير صالح.
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 لا تحتوي بيانات الأحداث على معرّفات المستخدمين أو معرّفات الإعلانات.
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 قيمة الحقل طويلة جدًا.
TOO_MANY_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 لا يُسمح بالحد الأقصى للتكلفة إلا لنوع التكلفة 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 أنواع الحسابات غير متاحة لنوع قائمة المستخدِمين.

الحدث

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

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

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

double

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

EventParameter

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

الحقول
parameter_name

string

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

string

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

EventSource

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

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

ExperimentalField

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

الحقول
field

string

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

string

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

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}

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

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

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

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

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 - معرّف يقدّمه الشريك - معرّف يقدّمه الناشر - معرّف المعلِنين على iOS - المعرّف الإعلاني على Android - معرّف Roku - معرّف Amazon Fire TV - معرّف Xbox أو Microsoft

العنصر

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

الحقول
merchant_product_id

string

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

int64

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

double

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

string

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

ItemParameter

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

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).

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

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

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

  • 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).

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

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

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

  • 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).

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

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

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

  • 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").

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

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

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

  • 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]).

MobileData

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

الحقول
mobile_ids[]

string

الحقل مطلوب. قائمة أرقام تعريف الأجهزة الجوّالة (المعرّف الإعلاني أو معرّف المعلِنين/IDFA) يمكن تقديم 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 وتشفيرها باستخدام تشفير تبادلي منحنى إهليلجي باستخدام مفتاح الناشر لقائمة المستخدِمين PAIR يمكن تقديم 10 pairIds كحدّ أقصى في AudienceMember واحد.

PairIdInfo

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

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

الحقول
match_rate_percentage

int32

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

int64

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

int64

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

string

اختياريّ. اسم وصفي للناشر سيتم عرضه في واجهة المستخدم لتوفير تجربة استهداف أفضل.
clean_room_identifier

string

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

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 مصدر بيانات الجمهور الخاص بالشركاء هو جمهور الوكالة/المزوّد.

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 حاول المستخدِم إدخال أحداث باستخدام معرّف إعلاني لا يعود إلى إعلانات الحساب التشغيلي.

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 باستخدام مفتاح تشفير البيانات (DEK).
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.

PseudonymousIdInfo

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

الحقول
sync_status

SyncStatus

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

int64

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

SyncStatus

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

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

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

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

RequestStatusPerDestination

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

الحقول
destination

Destination

وجهة ضمن طلب DM API
request_status

RequestStatus

حالة الطلب للوجهة.
error_info

ErrorInfo

خطأ في معلومات الخطأ يتضمّن سبب الخطأ وعدد الأخطاء المرتبطة بعملية التحميل
warning_info

WarningInfo

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

IngestAudienceMembersStatus

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

IngestEventsStatus

تمثّل هذه السمة حالة طلب أحداث الاستيعاب.
audience_members_removal_status

RemoveAudienceMembersStatus

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

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

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

IngestEventsStatus

تمثّل هذه السمة حالة استيعاب الأحداث في الوجهة.

الحقول
record_count

int64

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

IngestMobileDataStatus

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

الحقول
record_count

int64

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

int64

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

IngestPairDataStatus

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

الحقول
record_count

int64

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

int64

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

IngestPpidDataStatus

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

الحقول
record_count

int64

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

int64

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

IngestUserDataStatus

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

الحقول
record_count

int64

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

int64

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

MatchRateRange

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

IngestUserIdDataStatus

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

الحقول
record_count

int64

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

int64

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

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

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

RemoveMobileDataStatus

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

الحقول
record_count

int64

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

int64

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

RemovePairDataStatus

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

الحقول
record_count

int64

إجمالي عدد أفراد الجمهور المُرسَلين في طلب الإزالة. يتضمّن جميع أفراد الجمهور في الطلب، بغض النظر عمّا إذا تمت إزالتهم بنجاح أم لا.
pair_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 تم إرسال الطلب بنجاح.
PROCESSING جارٍ معالجة الطلب.
FAILED تعذّر تنفيذ الطلب.
PARTIAL_SUCCESS تم إرسال الطلب جزئيًا.

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

طلب للحصول على حالة الطلب المقدَّم إلى واجهة برمجة التطبيقات "إدارة الأجهزة" لمعرّف طلب معيّن تعرض 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

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

string

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

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

string

اختياريّ. سلسلة فلترة يجب أن تكون جميع الحقول على يمين كل شرط (مثلاً: partner_link_id = 123456789).

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

  • AND
  • =
  • !=

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

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

مثلاً: owning_account.account_type = "GOOGLE_ADS" OR 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. هؤلاء هم الأعضاء المتاحون للاستهداف في "الحملات على شبكة البحث".

TargetNetworkInfo

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

الحقول
eligible_for_display

bool

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

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

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

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
USER_LIST_GLOBAL_LICENSE_TYPE_DATA_MART_BUY_SIDE ترخيص "جانب الشراء" في DataMart

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

اختياريّ. العملة التي يتم تحديد التكلفة و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

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

WarningCount

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

الحقول
record_count

int64

عدد السجلات التي تتضمّن تحذيرًا
reason

ProcessingWarningReason

سبب التحذير

WarningInfo

عدد التحذيرات لكل نوع من أنواع التحذيرات

الحقول
warning_counts[]

WarningCount

قائمة بالتحذيرات وعددها لكل سبب تحذير