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. Data Manager API hỗ trợ việc tạo mối liên kết với đố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.

Tạo 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.

Hãy 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 một đối tượng ProductAccount.

Đặt account_type thành AccountType của tài khoản đối tác. Ví dụ: nếu mối 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, 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.

Tạo yêu cầu

Để tạo một đường liên kết đối tác, hãy tạo một 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 đã tạo.

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 chính 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 mối liên kết với 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 API 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 API 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 DV360

Mở trong API 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 đã tạo 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.

Xóa liên kết

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