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 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 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 mối liên kết là giữa tài khoản nhà quảng cáo và 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 mối liên kết với 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.

Mở trong API Explorer 
{
    "owningAccount": {
        "accountType": "GOOGLE_ADS",
        "accountId": "INSERT_GOOGLE_ADS_CUSTOMER_ID"
    },
    "partnerAccount": {
        "accountType": "DATA_PARTNER",
        "accountId": "INSERT_DATA_PARTNER_ACCOUNT_ID"
    }
}

Nhà quảng cáo DV360

Mở trong API Explorer 
{
    "owningAccount": {
        "accountType": "DISPLAY_VIDEO_ADVERTISER",
        "accountId": "INSERT_DISPLAY_VIDEO_ADVERTISER_ID"
    },
    "partnerAccount": {
        "accountType": "DATA_PARTNER",
        "accountId": "INSERT_DATA_PARTNER_ACCOUNT_ID"
    }
}

Đối tác DV360

Mở trong API Explorer 
{
    "owningAccount": {
        "accountType": "DISPLAY_VIDEO_PARTNER",
        "accountId": "INSERT_DISPLAY_VIDEO_PARTNER_ID"
    },
    "partnerAccount": {
        "accountType": "DATA_PARTNER",
        "accountId": "INSERT_DATA_PARTNER_ACCOUNT_ID"
    }
}

Mở trong API Explorer 
{
    "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 cùng 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 lỗi để xác định nguyên nhân, 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á 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.

Trước
Tổng quan
Tiếp
Truy xuất đường liên kết của đối tác