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

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

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

AudienceMember

تمثّل هذه السمة الفرد من الجمهور الذي سيتم إجراء العملية عليه.

الحقول
destination_references[]

string

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

Consent

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

UserData

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

PairData

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

MobileData

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

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 تم الرفض.

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

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

الحقول
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 العميل بارز.

الوجهة

منتج 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

ErrorCount

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

الحقول
record_count

int64

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

ProcessingErrorReason

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

ErrorInfo

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

الحقول
error_counts[]

ErrorCount

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

الحدث

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

الحقول
destination_references[]

string

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

string

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

Timestamp

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

Timestamp

اختيارية: آخر مرة تم فيها تعديل الحدث
user_data

UserData

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

Consent

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

AdIdentifiers

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

string

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

double

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

EventSource

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

DeviceInfo

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

CartData

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

CustomVariable

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

ExperimentalField

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

UserProperties

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

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

string

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

KeyType

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

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

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

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

العنصر

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

الحقول
merchant_product_id

string

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

int64

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

double

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

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 واحد.

PairData

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

الحقول
pair_ids[]

string

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

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_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 حدث خطأ داخلي.

المنتج

تمّ الإيقاف. يمكنك استخدام 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 شريك البيانات

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

وجهة ضمن طلب البيانات من واجهة برمجة تطبيقات الرسائل المباشرة
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

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

IngestEventsStatus

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

الحقول
record_count

int64

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

IngestMobileDataStatus

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

الحقول
record_count

int64

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

int64

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

IngestPairDataStatus

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

الحقول
record_count

int64

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

int64

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

IngestUserDataStatus

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

الحقول
record_count

int64

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

int64

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

MatchRateRange

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

RemoveAudienceMembersStatus

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

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

RemoveUserDataStatus

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

RemoveMobileDataStatus

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

RemovePairDataStatus

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

RemoveMobileDataStatus

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

الحقول
record_count

int64

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

int64

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

RemovePairDataStatus

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

الحقول
record_count

int64

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

int64

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

RemoveUserDataStatus

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

الحقول
record_count

int64

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

int64

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

RequestStatus

حالة الطلب

عمليات التعداد
REQUEST_STATUS_UNKNOWN حالة الطلب غير معروفة.
SUCCESS تم إرسال الطلب بنجاح.
PROCESSING جارٍ معالجة الطلب.
FAILED تعذّر تنفيذ الطلب.
PARTIAL_SUCCESS تم إرسال الطلب جزئيًا.

RetrieveRequestStatusRequest

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

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

string

الحقل مطلوب. الحقل مطلوب. معرّف الطلب الخاص بطلب Data Manager API.

RetrieveRequestStatusResponse

ردّ من RetrieveRequestStatusRequest

الحقول
request_status_per_destination[]

RequestStatusPerDestination

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

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 حالة تشير إلى أنّ المتصل اختار رفض بنود الخدمة.

UserData

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

الحقول
user_identifiers[]

UserIdentifier

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

UserIdentifier

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

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

string

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

string

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

AddressInfo

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

UserProperties

معلومات يقدّمها المعلِن عن المستخدِم في وقت وقوع الحدث. لمزيد من التفاصيل، يُرجى الانتقال إلى https://support.google.com/google-ads/answer/14007601.

الحقول
customer_type

CustomerType

اختيارية: نوع العميل المرتبط بالحدث.
customer_value_bucket

CustomerValueBucket

اختيارية: قيمة العميل التي يحدّدها المعلِن

WarningCount

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

الحقول
record_count

int64

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

ProcessingWarningReason

سبب التحذير.

WarningInfo

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

الحقول
warning_counts[]

WarningCount

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