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

כך יוצרים או מוחקים משאב ב-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 ליצירת קישור לחשבון של שותף נתונים בסוגים שונים של חשבונות מפרסמים.

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

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

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

{
    "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 שמוגדר לשם המשאב. מגדירים כותרות לפי הצורך.