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

วิธีสร้างหรือลบทรัพยากร 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"
        }
    }
}

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

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