Creare o eliminare un link del partner

Ecco come creare o eliminare una risorsa PartnerLink. L'API Data Manager supporta la creazione di link partner per i seguenti tipi di account:

  • Account Google Ads
  • Account partner Display & Video 360 o inserzionista Display & Video 360

Crea un PartnerLink inviando un CreatePartnerLinkRequest.

Costruisci il corpo della richiesta

Crea una risorsa PartnerLink. Ecco i campi da impostare.

owning_account

Identifica l'account inserzionista proprietario del collegamento. Impostato su un oggetto ProductAccount.

Imposta account_type su AccountType dell'account inserzionista.

Imposta account_id sull'ID dell'account inserzionista.

Consulta la guida alle destinazioni e alle intestazioni per istruzioni sull'ID da utilizzare per ogni tipo di inserzionista.

partner_account

Identifica l'account partner. Impostato su un oggetto ProductAccount.

Imposta account_type su AccountType dell'account partner. Ad esempio, se il collegamento è da un account inserzionista a un account partner di dati, imposta questo campo su DATA_PARTNER.

Imposta account_id sull'ID dell'account partner.

Crea la richiesta

Per creare un link partner, crea un CreatePartnerLinkRequest.

  1. Imposta parent sul nome della risorsa dell'account inserzionista. Utilizza il formato:

    accountTypes/{account_type}/accounts/{account}
    
  2. Imposta partner_link sulla risorsa PartnerLink che hai creato.

  3. Se le tue credenziali sono per un Account Google con accesso a un account principale dell'account inserzionista, ad esempio un account amministratore Google Ads o un account partner Display & Video 360, imposta l'intestazione login-account come descritto in Configurare destinazioni e intestazioni.

Di seguito sono riportate richieste di esempio in formato JSON per creare un collegamento a un account partner di dati in diversi tipi di account inserzionista.

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

Inserzionista DV360

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

Partner DV360

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

Invia la richiesta

Invia la richiesta e, se necessario, includi le intestazioni della richiesta. Utilizza le credenziali di un Account Google con accesso a owning_account.

Se la richiesta ha esito positivo, la risposta contiene l'oggetto PartnerLink creato con i campi id e name compilati.

Se la richiesta non va a buon fine, esamina gli errori per determinare la causa del problema, aggiorna la richiesta e le intestazioni per risolvere eventuali problemi, quindi invia la richiesta e le intestazioni aggiornate.

Per eliminare un PartnerLink, invia una DeletePartnerLinkRequest con name impostato sul nome della risorsa. Se necessario, imposta le intestazioni.