REST Resource: customers.inboundCustomerLinks

• المورد: CustomerLink
  • تمثيل JSON
  • AccessType
• الطُرق

المورد: CustomerLink

يمثّل رابطًا بين عميلَي Ads Data Hub.

تمثيل JSON
{ "name": string, "customerId": string, "displayName": string, "accessTypes": [ enum (AccessType) ], "status": enum (LinkStatus), "updateTime": string, "directParentCustomerIds": [ string ] }

الحقول
name	string الاسم الذي يعرّف رابط العميل بشكلٍ فريد. تحتوي الروابط الواردة على نموذج العملاء/[customerId]/inboundCustomerLinks/[linkedCustomerId]. وتحتوي الروابط الصادرة على العملاء نموذجًا/[customerId]/outboundCustomerLinks/[linkedCustomerId].
customerId	string (int64 format) الرقم التعريفي لعميل Ads Data Hub المرتبط.
displayName	string الاسم المعروض للعميل المرتبط.
accessTypes[]	enum (AccessType) أنواع الوصول التي يتم الكشف عنها من خلال هذا الرابط
status	enum (LinkStatus) حالة رابط العميل.
updateTime	string (Timestamp format) وقت آخر تعديل لحالة الرابط. طابع زمني بتنسيق RFC3339 UTC "Zulu"، بدقة نانو ثانية وما يصل إلى تسعة أرقام كسور. أمثلة: "2014-10-02T15:01:23Z" و"2014-10-02T15:01:23.045123456Z".
directParentCustomerIds[]	string (int64 format) سيتم ضبط هذا الحقل للروابط الواردة فقط. يشير هذا الحقل إلى أنّ العميل الذي تمّ ربط حسابه قد يكون مرتبطًا مباشرةً أو لا، أنّه يشير إلى العميل الذي تم ربط العميل المرتبط به مباشرةً. بمعنى أنه يحصل العميل الحالي على إذن الوصول إلى العميل المرتبط من خلال العلاقة غير المباشرة التي تم ربطها من خلال الوالدين المباشرين. على سبيل المثال، إذا كانت الإدارة "ب" تدير "ب" وتدير "ج"، سيتم إدراج "ج" كرابط وارد "أ" في "#39" مع ضبط Direct_parent_customer_id على "ب". وفي حالات الروابط المباشرة، سيتضمّن الرقم التعريفي للعميل للعميل الحالي.

نوع الوصول

أنواع الوصول المسموح به.

عمليات التعداد
ACCESS_TYPE_UNSPECIFIED	نوع وصول غير محدّد.
ADS_DATA	إذا كان هذا الرابط واردًا، يعني ذلك أن العميل المرتبط قد منح حق الوصول إلى بيانات إعلانات Ads Data Hub ويمكن إدراجه كـ adsDataCustomerId أثناء تنفيذ طلبات البحث. إذا كان هذا رابطًا صادرًا، سيتمكّن العميل المرتبط من الوصول إلى بيانات إعلانات العميل الحالية.
MATCH_DATA	إذا كان هذا رابطًا واردًا، يكون العميل المرتبط قد قدّم حق الوصول إلى بيانات جدول مطابقة Ads Data Hub، ويمكن إدراجه كمطابقة dataDataCustomerId أثناء تنفيذ طلب البحث. إذا كان هذا رابطًا صادرًا، سيتمكّن العميل المرتبط من الوصول إلى بيانات جدول مطابقة العملاء الحاليين.
MANAGEMENT	تحدّد روابط الإدارة كيفية نشر أذونات الروابط على مستوى العملاء. على سبيل المثال، إذا كان للرابط "أ" رابط لإدارة الوارد إلى "ب" و"ب" يحتوي على رابط بيانات الإعلانات الواردة إلى "ج"، فإن "أ" يحتوي على رابط بيانات الإعلانات الواردة غير المباشرة إلى "ج". إذا كانت الإدارة "أ" تدير "ب" و"ب"، سيحصل "أ" على روابط الإدارة الواردة لكل من "ب" و"ج"، وسيكون لدى "ج" روابط إدارة صادرة إلى كل من "أ" و"ب".
AUDIENCE_LIST	إذا كان هذا الرابط واردًا، يكون العميل المرتبط قد منح إذن الوصول لإنشاء جمهور نيابةً عنه. إذا كان هذا رابطًا صادرًا، يمكن للعميل المرتبط إنشاء جمهور نيابةً عن العميل الحالي.

الطُرق
list	يعرض روابط حيث منح عميل Ads Data Hub آخر حق الوصول إلى العميل المحدّد.