יצירה או מחיקה של קישור לשותף

כך יוצרים או מוחקים משאב PartnerLink. ה-Data Manager API תומך ביצירת קישורים לשותפים בסוגי החשבונות הבאים:

• חשבונות Google Ads
• חשבונות שותפים או חשבונות מפרסמים ב-Display & Video 360
• חשבונות Google Ad Manager

יצירת קישור

יוצרים PartnerLink על ידי שליחת CreatePartnerLinkRequest.

יצירת גוף הבקשה

יוצרים משאב PartnerLink. אלה השדות שצריך להגדיר.

owning_account

מזהה את חשבון המפרסם שהקישור שייך לו. מוגדר לאובייקט ProductAccount.

מגדירים את account_type לערך AccountType של חשבון המפרסם.

מגדירים את הערך account_id למזהה של חשבון המפרסם.

ההוראות לגבי המזהה שצריך להשתמש בו לכל סוג של מפרסם מפורטות במדריך ליעדים ולכותרות.

partner_account

מזהה את חשבון השותף. מוגדר לאובייקט ProductAccount.

מגדירים את account_type לערך AccountType של חשבון השותף. לדוגמה, אם הקישור הוא מחשבון מפרסם לחשבון שותף נתונים, צריך להגדיר את השדה הזה לערך DATA_PARTNER.

מגדירים את account_id למספר החשבון של השותף.

יצירת הבקשה

כדי ליצור קישור לשותף, צריך ליצור CreatePartnerLinkRequest.

1. מגדירים את הערך parent לשם המשאב של חשבון המפרסם. צריך להשתמש בפורמט:

   accountTypes/{account_type}/accounts/{account}
   

2. מגדירים את partner_link למשאב PartnerLink שיצרתם.

3. אם פרטי הכניסה הם לחשבון Google עם גישה לחשבון הורה של חשבון המפרסם, כמו חשבון ניהול ב-Google Ads או חשבון שותף ב-Display & Video 360, צריך להגדיר את הכותרת login-account כמו שמתואר במאמר הגדרת יעדים וכותרות.

הנה דוגמאות לבקשות ב-JSON ליצירת קישור לחשבון של שותף נתונים בסוגים שונים של חשבונות מפרסמים.

Google Ads

פתיחה ב-API Explorer

{
    "owningAccount": {
        "accountType": "GOOGLE_ADS",
        "accountId": "INSERT_GOOGLE_ADS_CUSTOMER_ID"
    },
    "partnerAccount": {
        "accountType": "DATA_PARTNER",
        "accountId": "INSERT_DATA_PARTNER_ACCOUNT_ID"
    }
}

מפרסם ב-DV360

פתיחה ב-API Explorer

{
    "owningAccount": {
        "accountType": "DISPLAY_VIDEO_ADVERTISER",
        "accountId": "INSERT_DISPLAY_VIDEO_ADVERTISER_ID"
    },
    "partnerAccount": {
        "accountType": "DATA_PARTNER",
        "accountId": "INSERT_DATA_PARTNER_ACCOUNT_ID"
    }
}

שותף ב-DV360

פתיחה ב-API Explorer

{
    "owningAccount": {
        "accountType": "DISPLAY_VIDEO_PARTNER",
        "accountId": "INSERT_DISPLAY_VIDEO_PARTNER_ID"
    },
    "partnerAccount": {
        "accountType": "DATA_PARTNER",
        "accountId": "INSERT_DATA_PARTNER_ACCOUNT_ID"
    }
}

Google Ad Manager

פתיחה ב-API Explorer

{
    "owningAccount": {
        "accountType": "GOOGLE_AD_MANAGER_AUDIENCE_LINK",
        "accountId": "INSERT_GAM_AUDIENCE_LINK_ID"
    },
    "partnerAccount": {
        "accountType": "DATA_PARTNER",
        "accountId": "INSERT_DATA_PARTNER_ACCOUNT_ID"
    }
}

שליחת הבקשה

שולחים את הבקשה וכוללים כותרות בקשה אם נדרש. להשתמש בפרטי כניסה לחשבון Google עם גישה ל-owning_account.

אם הבקשה מצליחה, התגובה מכילה את PartnerLink שנוצר, עם הערכים id ו-name.

אם הבקשה נכשלת, בודקים את השגיאות כדי לזהות את הגורם לכישלון, מעדכנים את הבקשה ואת הכותרות כדי לפתור את הבעיות, ואז שולחים את הבקשה והכותרות המעודכנות.

מחיקת קישור

כדי למחוק PartnerLink, שולחים DeletePartnerLinkRequest עם name שמוגדר לשם המשאב. אם צריך, מגדירים כותרות.