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
Creare un link
Crea un PartnerLink inviando un CreatePartnerLinkRequest.
Costruisci il corpo della richiesta
Crea una risorsa PartnerLink. Ecco i campi da impostare.
owning_accountIdentifica l'account inserzionista proprietario del collegamento. Impostato su un oggetto
ProductAccount.Imposta
account_typesuAccountTypedell'account inserzionista.Imposta
account_idsull'ID dell'account inserzionista.Consulta la guida alle destinazioni e alle intestazioni per istruzioni sull'ID da utilizzare per ogni tipo di inserzionista.
partner_accountIdentifica l'account partner. Impostato su un oggetto
ProductAccount.Imposta
account_typesuAccountTypedell'account partner. Ad esempio, se il collegamento è da un account inserzionista a un account partner di dati, imposta questo campo suDATA_PARTNER.Imposta
account_idsull'ID dell'account partner.
Crea la richiesta
Per creare un link partner, crea un CreatePartnerLinkRequest.
Imposta
parentsul nome della risorsa dell'account inserzionista. Utilizza il formato:accountTypes/{account_type}/accounts/{account}Imposta
partner_linksulla risorsaPartnerLinkche hai creato.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-accountcome 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.
Google Ads
{ "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.
Elimina un collegamento
Per eliminare un PartnerLink, invia una DeletePartnerLinkRequest con name
impostato sul nome della risorsa. Se necessario, imposta le intestazioni.