Package google.ads.datamanager.v1

الفهرس

• IngestionService (واجهة)
• MarketingDataInsightsService (واجهة)
• PartnerLinkService (واجهة)
• UserListDirectLicenseService (واجهة)
• UserListGlobalLicenseService (واجهة)
• UserListService (واجهة)
• AdIdentifiers (رسالة)
• AddressInfo (رسالة)
• AgeRange (تعداد)
• AudienceMember (رسالة)
• AwsWrappedKeyInfo (رسالة)
• AwsWrappedKeyInfo.KeyType (تعداد)
• Baseline (رسالة)
• Baseline.Location (رسالة)
• CartData (رسالة)
• Consent (رسالة)
• ConsentStatus (تعداد)
• ContactIdInfo (رسالة)
• CreatePartnerLinkRequest (رسالة)
• CreateUserListDirectLicenseRequest (رسالة)
• CreateUserListGlobalLicenseRequest (رسالة)
• CreateUserListRequest (رسالة)
• CustomVariable (رسالة)
• CustomerType (تعداد)
• CustomerValueBucket (تعداد)
• DataSourceType (تعداد)
• DeletePartnerLinkRequest (رسالة)
• DeleteUserListRequest (رسالة)
• Destination (رسالة)
• DeviceInfo (رسالة)
• Encoding (تعداد)
• EncryptionInfo (رسالة)
• ErrorCount (رسالة)
• ErrorInfo (رسالة)
• ErrorReason (تعداد)
• Event (رسالة)
• EventParameter (رسالة)
• EventSource (تعداد)
• ExperimentalField (رسالة)
• GcpWrappedKeyInfo (رسالة)
• GcpWrappedKeyInfo.KeyType (تعداد)
• Gender (تعداد)
• GetUserListDirectLicenseRequest (رسالة)
• GetUserListGlobalLicenseRequest (رسالة)
• GetUserListRequest (رسالة)
• IngestAudienceMembersRequest (رسالة)
• IngestAudienceMembersResponse (رسالة)
• IngestEventsRequest (رسالة)
• IngestEventsResponse (رسالة)
• IngestedUserListInfo (رسالة)
• IngestedUserListInfo.UploadKeyType (تعداد)
• Item (رسالة)
• ItemParameter (رسالة)
• ListUserListDirectLicensesRequest (رسالة)
• ListUserListDirectLicensesResponse (رسالة)
• ListUserListGlobalLicenseCustomerInfosRequest (رسالة)
• ListUserListGlobalLicenseCustomerInfosResponse (رسالة)
• ListUserListGlobalLicensesRequest (رسالة)
• ListUserListGlobalLicensesResponse (رسالة)
• ListUserListsRequest (رسالة)
• ListUserListsResponse (رسالة)
• MatchRateRange (تعداد)
• MobileData (رسالة)
• MobileIdInfo (رسالة)
• MobileIdInfo.KeySpace (تعداد)
• PairData (رسالة)
• PairIdInfo (رسالة)
• PartnerAudienceInfo (رسالة)
• PartnerAudienceInfo.PartnerAudienceSource (تعداد)
• PartnerLink (رسالة)
• PpidData (رسالة)
• ProcessingErrorReason (تعداد)
• ProcessingWarningReason (تعداد)
• ‫Product (تعداد) (تم إيقافه نهائيًا)
• ProductAccount (رسالة)
• ProductAccount.AccountType (تعداد)
• PseudonymousIdInfo (رسالة)
• PseudonymousIdInfo.SyncStatus (تعداد)
• RemoveAudienceMembersRequest (رسالة)
• RemoveAudienceMembersResponse (رسالة)
• RequestStatusPerDestination (رسالة)
• RequestStatusPerDestination.IngestAudienceMembersStatus (رسالة)
• RequestStatusPerDestination.IngestEventsStatus (رسالة)
• RequestStatusPerDestination.IngestMobileDataStatus (رسالة)
• RequestStatusPerDestination.IngestPairDataStatus (رسالة)
• RequestStatusPerDestination.IngestPpidDataStatus (رسالة)
• RequestStatusPerDestination.IngestUserDataStatus (رسالة)
• RequestStatusPerDestination.IngestUserIdDataStatus (رسالة)
• RequestStatusPerDestination.RemoveAudienceMembersStatus (رسالة)
• RequestStatusPerDestination.RemoveMobileDataStatus (رسالة)
• RequestStatusPerDestination.RemovePairDataStatus (رسالة)
• RequestStatusPerDestination.RemovePpidDataStatus (رسالة)
• RequestStatusPerDestination.RemoveUserDataStatus (رسالة)
• RequestStatusPerDestination.RemoveUserIdDataStatus (رسالة)
• RequestStatusPerDestination.RequestStatus (تعداد)
• RetrieveInsightsRequest (رسالة)
• RetrieveInsightsResponse (رسالة)
• RetrieveInsightsResponse.MarketingDataInsight (رسالة)
• RetrieveInsightsResponse.MarketingDataInsight.AudienceInsightsDimension (تعداد)
• RetrieveInsightsResponse.MarketingDataInsight.MarketingDataInsightsAttribute (رسالة)
• RetrieveRequestStatusRequest (رسالة)
• RetrieveRequestStatusResponse (رسالة)
• SearchPartnerLinksRequest (رسالة)
• SearchPartnerLinksResponse (رسالة)
• SizeInfo (رسالة)
• TargetNetworkInfo (رسالة)
• TermsOfService (رسالة)
• TermsOfServiceStatus (تعداد)
• UpdateUserListDirectLicenseRequest (رسالة)
• UpdateUserListGlobalLicenseRequest (رسالة)
• UpdateUserListRequest (رسالة)
• UserData (رسالة)
• UserIdData (رسالة)
• UserIdInfo (رسالة)
• UserIdentifier (رسالة)
• UserList (رسالة)
• UserList.AccessReason (تعداد)
• UserList.AccessStatus (تعداد)
• UserList.ClosingReason (تعداد)
• UserList.MembershipStatus (تعداد)
• UserListDirectLicense (رسالة)
• UserListGlobalLicense (رسالة)
• UserListGlobalLicenseCustomerInfo (رسالة)
• UserListGlobalLicenseType (تعداد)
• UserListLicenseClientAccountType (تعداد)
• UserListLicenseMetrics (رسالة)
• UserListLicensePricing (رسالة)
• UserListLicensePricing.UserListPricingBuyerApprovalState (تعداد)
• UserListLicensePricing.UserListPricingCostType (تعداد)
• UserListLicenseStatus (تعداد)
• UserProperties (رسالة)
• UserProperty (رسالة)
• WarningCount (رسالة)
• WarningInfo (رسالة)

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

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

CreatePartnerLink

rpc CreatePartnerLink(CreatePartnerLinkRequest) returns (PartnerLink) تنشئ هذه الطريقة رابط شريك للحساب المحدّد. عناوين التفويض: تتيح هذه الطريقة استخدام العناوين الاختيارية التالية لتحديد كيفية منح واجهة برمجة التطبيقات إذن الوصول إلى الطلب: ‫login-account: (اختياري) اسم مورد الحساب الذي يكون فيه حساب Google الخاص ببيانات الاعتماد مستخدمًا. إذا لم يتم ضبطها، يتم تلقائيًا استخدام حساب الطلب. التنسيق: accountTypes/{loginAccountType}/accounts/{loginAccountId} ‫linked-account: (اختياري) اسم مورد الحساب الذي تم إنشاء رابط منتج ثابت به إلى login-account. التنسيق: accountTypes/{linkedAccountType}/accounts/{linkedAccountId} نطاقات الأذونات يجب توفير نطاق OAuth التالي: https://www.googleapis.com/auth/datamanager

DeletePartnerLink

rpc DeletePartnerLink(DeletePartnerLinkRequest) returns (Empty) تحذف هذه الطريقة رابط شريك للحساب المحدّد. عناوين التفويض: تتيح هذه الطريقة استخدام العناوين الاختيارية التالية لتحديد كيفية منح واجهة برمجة التطبيقات إذن الوصول إلى الطلب: ‫login-account: (اختياري) اسم مورد الحساب الذي يكون فيه حساب Google الخاص ببيانات الاعتماد مستخدمًا. إذا لم يتم ضبطها، يتم تلقائيًا استخدام حساب الطلب. التنسيق: accountTypes/{loginAccountType}/accounts/{loginAccountId} ‫linked-account: (اختياري) اسم مورد الحساب الذي تم إنشاء رابط منتج ثابت به إلى login-account. التنسيق: accountTypes/{linkedAccountType}/accounts/{linkedAccountId} نطاقات الأذونات يجب توفير نطاق OAuth التالي: https://www.googleapis.com/auth/datamanager

SearchPartnerLinks

rpc SearchPartnerLinks(SearchPartnerLinksRequest) returns (SearchPartnerLinksResponse) يبحث عن جميع روابط الشركاء من حساب معيّن وإليه. عناوين التفويض: تتيح هذه الطريقة استخدام العناوين الاختيارية التالية لتحديد كيفية منح واجهة برمجة التطبيقات إذن الوصول إلى الطلب: ‫login-account: (اختياري) اسم مورد الحساب الذي يكون فيه حساب Google الخاص ببيانات الاعتماد مستخدمًا. إذا لم يتم ضبطها، يتم تلقائيًا استخدام حساب الطلب. التنسيق: accountTypes/{loginAccountType}/accounts/{loginAccountId} ‫linked-account: (اختياري) اسم مورد الحساب الذي تم إنشاء رابط منتج ثابت به إلى login-account. التنسيق: accountTypes/{linkedAccountType}/accounts/{linkedAccountId} نطاقات الأذونات يجب توفير نطاق OAuth التالي: https://www.googleapis.com/auth/datamanager

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}
partner_link	PartnerLink الحقل مطلوب. رابط الشريك المطلوب إنشاؤه.

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	أنواع الحسابات غير متاحة لنوع قائمة المستخدِمين.
UNSUPPORTED_ACCOUNT_TYPE_FOR_PARTNER_LINK	أنواع الحسابات غير متاحة لربط الحساب بالشريك.

الحدث

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

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

PartnerLink

رابط شريك بين حساب مالك وحساب شريك

الحقول
name	string المعرّف تمثّل هذه السمة اسم رابط الشريك. التنسيق: accountTypes/{account_type}/accounts/{account}/partnerLinks/{partner_link}
partner_link_id	string النتائج فقط. معرّف رابط الشريك
owning_account	ProductAccount الحقل مطلوب. الحساب المالك الذي يمنح إذن الوصول إلى حساب الشريك
partner_account	ProductAccount الحقل مطلوب. حساب الشريك الذي منحه حساب المالك إذن الوصول

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_DENIED_CONSENT	يتم رفض بيانات مستخدم الإعلان، إما من قِبل المستخدم أو في الإعدادات التلقائية للمعلِن.
PROCESSING_ERROR_REASON_NO_CONSENT	لم يمنح المعلِن موافقة الطرف الثالث على خدمات المنصة الأساسية للإعلانات.
PROCESSING_ERROR_REASON_UNKNOWN_CONSENT	تعذّر تحديد الموافقة الإجمالية (المحدّدة من الموافقة على مستوى الصف والموافقة على مستوى الطلب وإعدادات الحساب) لهذا المستخدم
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.
GOOGLE_AD_MANAGER_AUDIENCE_LINK	رابط جمهور "إدارة إعلانات Google"

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

الحقول
partner_links[]	PartnerLink روابط الشريك للحساب المحدّد
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 الإعلانية".
eligible_for_search	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"
USER_LIST_LICENSE_CLIENT_ACCOUNT_TYPE_GOOGLE_AD_MANAGER_AUDIENCE_LINK	رابط جمهور "إدارة إعلانات Google"

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 قائمة بالتحذيرات وعددها لكل سبب تحذير