REST Resource: customers.inboundCustomerLinks

• מקור: CustomerLink
  • ייצוג JSON
  • סוג גישה
• שיטות

משאב: 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) השדה הזה יוגדר רק לקישורים נכנסים. מאחר שהלקוח המקושר עשוי להיות מקושר ישירות, שדה זה מציין את הלקוח שאליו הקישור מקושר. כלומר, הלקוח הנוכחי מקבל גישה ללקוח המקושר דרך הקשר העקיף שמקושר להורים הישירים. למשל, אם א' מנהל את ב' ו-ב מנהל את ג', ג' יופיע כקישור נכנס של A' כאשר ה-direct_parent_customer_id שלו מוגדר כ-B. במקרה של קישורים ישירים, הוא יכלול את מספר הלקוח של הלקוח הנוכחי.

סוג הגישה

סוגי הגישה מותרים.

Enums
ACCESS_TYPE_UNSPECIFIED	סוג הגישה לא צוין.
ADS_DATA	אם זהו קישור נכנס, הלקוח המקושר סיפק גישה לנתוני המודעות של Ads Data Hub וניתן לרשום אותו כ-AdsDataCustomerId במהלך הפעלת השאילתה. אם זהו קישור יוצא, ללקוח המקושר יש גישה לנתוני המודעות של הלקוח הנוכחי.
MATCH_DATA	אם זהו קישור נכנס, הלקוח המקושר סיפק גישה לנתוני טבלת ההתאמה של Ads Data Hub וניתן לרשום אותו כ-matchDataCustomerId במהלך הפעלת השאילתה. אם זהו קישור יוצא, ללקוח המקושר יש גישה לנתוני טבלת ההתאמה של הלקוח הנוכחי.
MANAGEMENT	קישורים לניהול מציינים את האופן שבו הרשאות הקישור מתפרסות על פני לקוחות שונים. למשל, אם ל-A יש קישור לניהול מודעות נכנסות ב-B ול-B יש קישור לנתוני מודעות נכנסות ל-C, אז ל-A יש קישור לנתוני מודעות נכנסות ל-C. אם א' מנהלת את ב' ו-ב' מנהלת ג', ל-א' יהיו קישורים לניהול ל-B וגם ל-C, ול-C יהיו קישורי ניהול יוצאים גם ל-א' וגם ל-ב'.
AUDIENCE_LIST	אם זהו קישור נכנס, הלקוח המקושר סיפק גישה ליצירת קהל בשמם. אם זהו קישור לאתר אחר, הלקוח המקושר יכול ליצור קהל בשם הלקוח הנוכחי.

שיטות
list	רשימה של הקישורים שבהם לקוח אחר של Ads Data Hub נתן גישה ללקוח שצוין.