So erstellen oder löschen Sie eine PartnerLink-Ressource: Die Data Manager API unterstützt das Erstellen von Partnerverknüpfungen für die folgenden Kontotypen:
- Google Ads-Konten
- Display & Video 360-Partner- oder Display & Video 360-Werbetreibendenkonten
- Google Ad Manager-Konten
Verknüpfung erstellen
Erstellen Sie einen PartnerLink, indem Sie einen CreatePartnerLinkRequest senden.
Anfragetext erstellen
Erstellen Sie eine PartnerLink-Ressource. Hier sind die festzulegenden Felder.
owning_accountGibt das Werbetreibendenkonto an, zu dem die Verknüpfung gehört. Legen Sie ein
ProductAccount-Objekt fest.Legen Sie für
account_typedieAccountTypedes Werbetreibendenkontos fest.Legen Sie für
account_iddie ID des Werbetreibendenkontos fest.Eine Anleitung zur ID, die für jeden Werbetreibendentyp verwendet werden soll, finden Sie im Leitfaden zu Zielen und Headern.
partner_accountIdentifiziert das Partnerkonto. Legen Sie ein
ProductAccount-Objekt fest.Legen Sie für
account_typedieAccountTypedes Partnerkontos fest. Wenn die Verknüpfung beispielsweise von einem Werbetreibendenkonto zu einem Datenpartnerkonto besteht, legen Sie dieses Feld aufDATA_PARTNERfest.Legen Sie für
account_iddie ID des Partnerkontos fest.
Erstellen Sie die Anfrage
Wenn Sie einen Partnerlink erstellen möchten, erstellen Sie einen CreatePartnerLinkRequest.
Legen Sie für
parentden Ressourcennamen des Werbetreibendenkontos fest. Verwenden Sie das Format:accountTypes/{account_type}/accounts/{account}Legen Sie für
partner_linkdie von Ihnen erstelltePartnerLink-Ressource fest.Wenn Ihre Anmeldedaten für ein Google-Konto mit Zugriff auf ein übergeordnetes Konto des Werbetreibendenkontos gelten, z. B. ein Google Ads-Verwaltungskonto oder ein Display & Video 360-Partnerkonto, legen Sie den Header
login-accountwie unter Ziele und Header konfigurieren beschrieben fest.
Hier finden Sie Beispielanfragen im JSON-Format, um eine Verknüpfung mit einem Datenpartnerkonto in verschiedenen Arten von Werbetreibendenkonten zu erstellen.
Google Ads
{ "owningAccount": { "accountType": "GOOGLE_ADS", "accountId": "INSERT_GOOGLE_ADS_CUSTOMER_ID" }, "partnerAccount": { "accountType": "DATA_PARTNER", "accountId": "INSERT_DATA_PARTNER_ACCOUNT_ID" } }
DV360-Werbetreibender
{ "owningAccount": { "accountType": "DISPLAY_VIDEO_ADVERTISER", "accountId": "INSERT_DISPLAY_VIDEO_ADVERTISER_ID" }, "partnerAccount": { "accountType": "DATA_PARTNER", "accountId": "INSERT_DATA_PARTNER_ACCOUNT_ID" } }
DV360-Partner
{ "owningAccount": { "accountType": "DISPLAY_VIDEO_PARTNER", "accountId": "INSERT_DISPLAY_VIDEO_PARTNER_ID" }, "partnerAccount": { "accountType": "DATA_PARTNER", "accountId": "INSERT_DATA_PARTNER_ACCOUNT_ID" } }
Google Ad Manager
{ "owningAccount": { "accountType": "GOOGLE_AD_MANAGER_AUDIENCE_LINK", "accountId": "INSERT_GAM_AUDIENCE_LINK_ID" }, "partnerAccount": { "accountType": "DATA_PARTNER", "accountId": "INSERT_DATA_PARTNER_ACCOUNT_ID" } }
Anfrage senden
Senden Sie die Anfrage und fügen Sie bei Bedarf Anfrageheader hinzu. Verwenden Sie die Anmeldedaten für ein Google-Konto mit Zugriff auf owning_account.
Wenn die Anfrage erfolgreich ist, enthält die Antwort die erstellte PartnerLink mit den ausgefüllten Feldern id und name.
Wenn die Anfrage fehlschlägt, prüfen Sie die Fehler, um die Ursache des Fehlers zu ermitteln, aktualisieren Sie die Anfrage und die Header, um alle Probleme zu beheben, und senden Sie dann die aktualisierte Anfrage und die Header.
Verknüpfung löschen
Wenn Sie eine PartnerLink löschen möchten, senden Sie eine DeletePartnerLinkRequest, wobei name auf den Ressourcennamen festgelegt ist. Legen Sie bei Bedarf Header fest.