สร้างหรือลบลิงก์พาร์ทเนอร์

วิธีสร้างหรือลบทรัพยากร PartnerLink มีดังนี้ Data Manager API รองรับการสร้างลิงก์พาร์ทเนอร์สำหรับบัญชีประเภทต่อไปนี้

  • บัญชี Google Ads
  • บัญชีพาร์ทเนอร์ Display & Video 360 หรือบัญชีผู้ลงโฆษณา 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 เพื่อสร้างลิงก์ไปยังบัญชีพาร์ทเนอร์ด้านข้อมูลใน บัญชีผู้ลงโฆษณาประเภทต่างๆ

{
    "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

{
    "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

{
    "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 ตั้งค่าเป็นชื่อทรัพยากร ตั้งค่าส่วนหัว หากจำเป็น