Criar ou excluir um link de parceiro

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

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

Criar uma vinculação

Crie um PartnerLink enviando um CreatePartnerLinkRequest.

Construir o corpo da solicitação

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

owning_account

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

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 de parceiro. Defina como um ProductAccount objeto.

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 account_id como o ID da conta de parceiro.

Crie a solicitação

Para criar um vínculo de parceiro, construa um CreatePartnerLinkRequest.

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

   accountTypes/{account_type}/accounts/{account}
   

2. Defina 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 para uma conta de parceiro de dados em diferentes tipos de contas de anunciante.

{
    "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"
        }
    }
}

{
    "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"
        }
    }
}

{
    "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 credenciais de uma Conta do Google com acesso à owning_account.

Se a solicitação for bem-sucedida, a resposta vai conter o PartnerLink criado com o id e o 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 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 os cabeçalhos, se necessário.