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 đến đố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ài khoản Google Ad Manager

Tạo 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. Dưới đâ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 một đố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 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 đường liên kết của đố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à của 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 đề.

Dưới đâ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 các loại tài khoản nhà quảng cáo khác nhau.

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

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

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

{
    "owningAccount": {
        "accountType": "GOOGLE_AD_MANAGER_AUDIENCE_LINK",
        "accountId": "INSERT_GAM_AUDIENCE_LINK_ID"
    },
    "partnerAccount": {
        "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 đề của yêu cầu nếu cần. Sử dụng thông tin đăng nhập của 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, trong đó có sẵn id và name.

Nếu yêu cầu không thành công, hãy kiểm tra 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 có name được đặt thành tên tài nguyên. Đặt tiêu đề nếu cần.