זהירות: אתה צופה בתיעוד עבור ממשק ה-API ל-REST. רוב ספריות הלקוחות הרשמיות שלנו משתמשות ב-gRPC. פרטים נוספים זמינים במבוא ל-REST.

דף זה תורגם על ידי Cloud Translation API.

AccountLink

ייצוג ב-JSON
AccountLinkStatus
LinkedAccountType
ThirdPartyAppAnalyticsLinkIdentifier
- ייצוג ב-JSON

מייצג את החיבור לשיתוף נתונים בין חשבון Google Ads לחשבון אחר

ייצוג ב-JSON

ייצוג ב-JSON
{ "resourceName": string, "status": enum (`AccountLinkStatus`), "type": enum (`LinkedAccountType`), "accountLinkId": string, // Union field `linked_account` can be only one of the following: "thirdPartyAppAnalytics": { object (`ThirdPartyAppAnalyticsLinkIdentifier`) } // End of list of possible types for union field `linked_account`. }

{
  "resourceName": string,
  "status": enum (AccountLinkStatus),
  "type": enum (LinkedAccountType),
  "accountLinkId": string,

  // Union field linked_account can be only one of the following:
  "thirdPartyAppAnalytics": {
    object (ThirdPartyAppAnalyticsLinkIdentifier)
  }
  // End of list of possible types for union field linked_account.
}

שדות
`resourceName`	`string` לא ניתן לשינוי. שם המשאב של קישור החשבון. שמות המשאבים של AccountLink הם בפורמט: `customers/{customerId}/accountLinks/{accountLinkId}`
`status`	`enum (AccountLinkStatus)` הסטטוס של הקישור.
`type`	`enum (LinkedAccountType)` פלט בלבד. סוג החשבון המקושר.
`accountLinkId`	`string (int64 format)` פלט בלבד. המזהה של הקישור. השדה הזה הוא לקריאה בלבד.
שדה האיחוד `linked_account`. חשבון שמקושר לחשבון Google Ads הזה. הערך של `linked_account` יכול להיות רק אחת מהאפשרויות הבאות:
`thirdPartyAppAnalytics`	`object (ThirdPartyAppAnalyticsLinkIdentifier)` לא ניתן לשינוי. קישור לשירות צד שלישי לניתוח של נתוני אפליקציות.

AccountLinkStatus

תיאור הסטטוסים האפשריים של קישור בין לקוח Google Ads לבין חשבון אחר.

טיפוסים בני מנייה (enum)
`UNSPECIFIED`	לא צוין.
`UNKNOWN`	משמש רק לערך המוחזר. מייצג ערך לא ידוע בגרסה הזו.
`ENABLED`	הקישור מופעל.
`REMOVED`	הקישור הוסר או הושבת.
`REQUESTED`	נשלחה בקשה לקישור לחשבון השני. עכשיו, משתמש בחשבון השני יכול לאשר את הקישור על ידי הגדרת הסטטוס ל-ENABLED.
`PENDING_APPROVAL`	משתמש בחשבון השני ביקש את הקישור הזה. משתמש בחשבון הזה יכול לאשר את הבקשה על ידי הגדרת הסטטוס ל-ENABLED.
`REJECTED`	הקישור נדחה על ידי המאשר.
`REVOKED`	המשתמש ששלח את הבקשה לקישור מבטל אותו.

LinkedAccountType

תיאור של סוגי הקישורים האפשריים בין לקוח Google Ads לחשבון אחר.

טיפוסים בני מנייה (enum)
`UNSPECIFIED`	לא צוין.
`UNKNOWN`	משמש רק לערך המוחזר. מייצג ערך לא ידוע בגרסה הזו.
`THIRD_PARTY_APP_ANALYTICS`	קישור לצורך העברת נתונים של ניתוח נתוני אפליקציות של צד שלישי.

ThirdPartyAppAnalyticsLinkIdentifier

המזהים של קישור לשירות ניתוח נתוני אפליקציות של צד שלישי.

ייצוג ב-JSON
{ "appVendor": enum (`MobileAppVendor`), "appAnalyticsProviderId": string, "appId": string }

שדות

שדות
`appVendor`	`enum (MobileAppVendor)` לא ניתן לשינוי. הספק של האפליקציה. השדה הזה לא יכול להיות ריק כשיוצרים קישור חדש לשירות צד שלישי לניתוח נתוני אפליקציות. לא ניתן לשנות אותו אחרי יצירת הקישור.
`appAnalyticsProviderId`	`string (int64 format)` לא ניתן לשינוי. המזהה של ספק שירותי ניתוח של נתוני אפליקציות. השדה הזה לא יכול להיות ריק כשיוצרים קישור חדש לשירות צד שלישי לניתוח של נתוני אפליקציות. לא ניתן לשנות אותו אחרי יצירת הקישור.
`appId`	`string` לא ניתן לשינוי. מחרוזת שמזהה באופן ייחודי אפליקציה לנייד שממנה נאספו הנתונים ל-Google Ads API. ב-iOS, מחרוזת המזהה היא המחרוזת בת 9 הספרות שמופיעה בסוף כתובת ה-URL של App Store (לדוגמה, '422689480' עבור 'Gmail', שהקישור שלה ב-App Store הוא https://apps.apple.com/us/app/gmail-email-by-google/id422689480). ב-Android, מחרוזת המזהה היא שם החבילה של האפליקציה (לדוגמה, 'com.google.android.gm' עבור 'Gmail' לפי הקישור ל-Google Play‏ https://play.google.com/store/apps/details?id=com.google.android.gm). השדה הזה לא יכול להיות ריק כשיוצרים קישור חדש לניתוח נתונים של אפליקציה של צד שלישי. לא ניתן לשנות אותו אחרי יצירת הקישור.

appVendor

enum (MobileAppVendor)

לא ניתן לשינוי. הספק של האפליקציה. השדה הזה לא יכול להיות ריק כשיוצרים קישור חדש לשירות צד שלישי לניתוח נתוני אפליקציות. לא ניתן לשנות אותו אחרי יצירת הקישור.

appAnalyticsProviderId

string (int64 format)

לא ניתן לשינוי. המזהה של ספק שירותי ניתוח של נתוני אפליקציות. השדה הזה לא יכול להיות ריק כשיוצרים קישור חדש לשירות צד שלישי לניתוח של נתוני אפליקציות. לא ניתן לשנות אותו אחרי יצירת הקישור.

appId

string

לא ניתן לשינוי. מחרוזת שמזהה באופן ייחודי אפליקציה לנייד שממנה נאספו הנתונים ל-Google Ads API. ב-iOS, מחרוזת המזהה היא המחרוזת בת 9 הספרות שמופיעה בסוף כתובת ה-URL של App Store (לדוגמה, '422689480' עבור 'Gmail', שהקישור שלה ב-App Store הוא https://apps.apple.com/us/app/gmail-email-by-google/id422689480). ב-Android, מחרוזת המזהה היא שם החבילה של האפליקציה (לדוגמה, 'com.google.android.gm' עבור 'Gmail' לפי הקישור ל-Google Play‏ https://play.google.com/store/apps/details?id=com.google.android.gm). השדה הזה לא יכול להיות ריק כשיוצרים קישור חדש לניתוח נתונים של אפליקציה של צד שלישי. לא ניתן לשנות אותו אחרי יצירת הקישור.