Criar ou excluir um link de parceiro

Saiba como criar ou excluir um recurso PartnerLink. A API Data Manager permite criar vínculos de parceiro para os seguintes tipos de conta:

• Contas do Google Ads
• Contas de parceiro ou anunciante do Display & Video 360

Criar um link

Crie um PartnerLink enviando um CreatePartnerLinkRequest.

Criar o corpo da solicitação

Crie um recurso PartnerLink. Confira os campos a serem definidos.

owning_account

Identifica a conta de anunciante proprietária do link. Definido como um objeto ProductAccount.

Defina o account_type como o AccountType da conta de anunciante.

Defina account_id como o ID da conta de anunciante.

Consulte o guia de destinos e cabeçalhos para instruções sobre o ID a ser usado para cada tipo de anunciante.

partner_account

Identifica a conta do parceiro. Definido como um objeto ProductAccount.

Defina o account_type como o AccountType da conta de parceiro. Por exemplo, se o link for de uma conta de anunciante para uma conta de parceiro de dados, defina esse campo como DATA_PARTNER.

Defina o account_id como o ID da conta de parceiro.

Crie a solicitação

Para criar uma vinculação de parceiro, crie um CreatePartnerLinkRequest.

1. Defina o parent como o nome do recurso da conta de anunciante. Use o formato:

   accountTypes/{account_type}/accounts/{account}
   

2. Defina o partner_link como o recurso PartnerLink que você construiu.

3. Se suas credenciais forem de uma Conta do Google com acesso a uma conta principal da conta de anunciante, como uma conta de administrador do Google Ads ou uma conta de parceiro do Display & Video 360, defina o cabeçalho login-account conforme descrito em Configurar destinos e cabeçalhos.

Confira exemplos de solicitações em JSON para criar um link com uma conta de parceiro de dados em diferentes tipos de contas de anunciante.

Google Ads

Abrir no 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"
        }
    }
}

Anunciante do DV360

Abrir no 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"
        }
    }
}

Parceiro do DV360

Abrir no 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"
        }
    }
}

Enviar a solicitação

Envie a solicitação e, se necessário, inclua cabeçalhos de solicitação. Use as credenciais de uma Conta do Google com acesso ao owning_account.

Se a solicitação for bem-sucedida, a resposta vai conter o PartnerLink criado com os campos id e name preenchidos.

Se a solicitação falhar, inspecione os erros para determinar a causa da falha, atualize a solicitação e os cabeçalhos para corrigir os problemas e envie a solicitação e os cabeçalhos atualizados.

Excluir um link

Para excluir um PartnerLink, envie um DeletePartnerLinkRequest com o name definido como o nome do recurso. Defina cabeçalhos, se necessário.