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

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

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

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

פתיחה ב-API Explorer 
{
    "parent": "accountTypes/GOOGLE_ADS/accounts/INSERT_GOOGLE_ADS_CUSTOMER_ID",
    "partner_link": {
        "owning_account": {
            "accountType": "GOOGLE_ADS",
            "accountId": "INSERT_GOOGLE_ADS_CUSTOMER_ID"
        },
        "partner_account": {
            "accountType": "DATA_PARTNER",
            "accountId": "INSERT_DATA_PARTNER_ACCOUNT_ID"
        }
    }
}

מפרסם ב-DV360

פתיחה ב-API Explorer 
{
    "parent": "accountTypes/DISPLAY_VIDEO_ADVERTISER/accounts/INSERT_DISPLAY_VIDEO_ADVERTISER_ID",
    "partner_link": {
        "owning_account": {
            "accountType": "DISPLAY_VIDEO_ADVERTISER",
            "accountId": "INSERT_DISPLAY_VIDEO_ADVERTISER_ID"
        },
        "partner_account": {
            "accountType": "DATA_PARTNER",
            "accountId": "INSERT_DATA_PARTNER_ACCOUNT_ID"
        }
    }
}

שותף ב-DV360

פתיחה ב-API Explorer 
{
    "parent": "accountTypes/DISPLAY_VIDEO_PARTNER/accounts/INSERT_DISPLAY_VIDEO_PARTNER_ID",
    "partner_link": {
        "owning_account": {
            "accountType": "DISPLAY_VIDEO_PARTNER",
            "accountId": "INSERT_DISPLAY_VIDEO_PARTNER_ID"
        },
        "partner_account": {
            "accountType": "DATA_PARTNER",
            "accountId": "INSERT_DATA_PARTNER_ACCOUNT_ID"
        }
    }
}

שליחת הבקשה

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

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

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

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

הקודם
סקירה כללית
הבא
אחזור קישורים של שותפים