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

כך יוצרים או מוחקים משאב של 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"
    }
}

מפרסם ב-DV360

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

שותף ב-DV360

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