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.

Crea il corpo della richiesta

Crea una risorsa PartnerLink. Ecco i campi da impostare.

owning_account

Identifica l'account inserzionista proprietario del link. Imposta su un ProductAccount oggetto.

Imposta account_type su AccountType dell'account inserzionista.

Imposta account_id sull'ID dell'account inserzionista.

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

partner_account

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

Imposta account_type su AccountType dell'account partner. Ad esempio, se il link va 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 JSON per creare un link a un account partner di dati in diversi tipi di account inserzionista.

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

Inserzionista DV360

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

Partner DV360

{
    "owningAccount": {
        "accountType": "DISPLAY_VIDEO_PARTNER",
        "accountId": "INSERT_DISPLAY_VIDEO_PARTNER_ID"
    },
    "partnerAccount": {
        "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 per un Account Google con accesso a owning_account.

Se la richiesta ha esito positivo, la risposta contiene il PartnerLink creato con il 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 un DeletePartnerLinkRequest con name impostato sul nome della risorsa. Imposta le intestazioni, se necessario.