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

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

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

Google Ads

เปิดในโปรแกรมสำรวจ API

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

ผู้ลงโฆษณา DV360

เปิดในโปรแกรมสำรวจ API

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

พาร์ทเนอร์ DV360

เปิดในโปรแกรมสำรวจ API

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

Google Ad Manager

เปิดในโปรแกรมสำรวจ API

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