Tạo hoặc xoá đường liên kết với đối tác

Sau đây là cách tạo hoặc xoá tài nguyên PartnerLink. API Trình quản lý dữ liệu hỗ trợ việc tạo đường liên kết đối tác cho các loại tài khoản sau:

• Các tài khoản Google Ads
• Tài khoản đối tác Display & Video 360 hoặc tài khoản nhà quảng cáo Display & Video 360

Tạo đường liên kết

Tạo PartnerLink bằng cách gửi CreatePartnerLinkRequest.

Xây dựng nội dung yêu cầu

Tạo tài nguyên PartnerLink. Sau đây là các trường cần đặt.

owning_account

Xác định tài khoản nhà quảng cáo sở hữu đường liên kết. Đặt thành đối tượng ProductAccount.

Đặt account_type thành AccountType của tài khoản nhà quảng cáo.

Đặt account_id thành mã nhận dạng của tài khoản nhà quảng cáo.

Tham khảo hướng dẫn về đích đến và tiêu đề để biết hướng dẫn về mã nhận dạng cần sử dụng cho từng loại nhà quảng cáo.

partner_account

Xác định tài khoản đối tác. Đặt thành đối tượng ProductAccount.

Đặt account_type thành AccountType của tài khoản đối tác. Ví dụ: nếu đường liên kết là từ tài khoản nhà quảng cáo đến tài khoản đối tác dữ liệu account, hãy đặt trường này thành DATA_PARTNER.

Đặt account_id thành mã nhận dạng của tài khoản đối tác.

Xây dựng yêu cầu

Để tạo đường liên kết đối tác, hãy xây dựng CreatePartnerLinkRequest.

1. Đặt parent thành tên tài nguyên của tài khoản nhà quảng cáo. Sử dụng định dạng:

   accountTypes/{account_type}/accounts/{account}
   

2. Đặt partner_link thành tài nguyên PartnerLink mà bạn đã xây dựng.

3. Nếu thông tin đăng nhập của bạn là cho một Tài khoản Google có quyền truy cập vào tài khoản mẹ của tài khoản nhà quảng cáo (chẳng hạn như tài khoản người quản lý Google Ads hoặc tài khoản Đối tác Display & Video 360 ), hãy đặt tiêu đề login-account như mô tả trong phần Định cấu hình đích đến và tiêu đề.

Sau đây là các yêu cầu mẫu ở định dạng JSON để tạo đường liên kết đến tài khoản đối tác dữ liệu trong nhiều loại tài khoản nhà quảng cáo.

Google Ads

Mở trong APIs 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"
        }
    }
}

Nhà quảng cáo Display & Video 360

Mở trong APIs 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"
        }
    }
}

Đối tác Display & Video 360

Mở trong APIs 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"
        }
    }
}

Gửi yêu cầu

Gửi yêu cầu và thêm tiêu đề yêu cầu (nếu cần). Sử dụng thông tin đăng nhập cho một Tài khoản Google có quyền truy cập vào owning_account.

Nếu yêu cầu thành công, phản hồi sẽ chứa PartnerLink với id và name được điền sẵn.

Nếu yêu cầu không thành công, hãy kiểm tra các lỗi để xác định nguyên nhân gây ra lỗi, cập nhật yêu cầu và tiêu đề để khắc phục mọi vấn đề, sau đó gửi yêu cầu và tiêu đề đã cập nhật.

Xoá đường liên kết

Để xoá PartnerLink, hãy gửi DeletePartnerLinkRequest với name được đặt thành tên tài nguyên. Đặt tiêu đề nếu cần.