Partnerlink erstellen oder löschen

Hier erfahren Sie, wie Sie eine PartnerLink-Ressource erstellen oder löschen. Die Data Manager API unterstützt das Erstellen von Partnerverknüpfungen für die folgenden Kontotypen:

• Google Ads-Konten
• Display &Video 360-Partnerkonten oder Display &Video 360-Werbetreibendenkonten

Verknüpfung erstellen

Erstellen Sie eine PartnerLink, indem Sie eine CreatePartnerLinkRequest senden.

Anfragetext erstellen

Erstellen Sie eine PartnerLink-Ressource. Legen Sie die folgenden Felder fest:

owning_account

Gibt das Werbetreibendenkonto an, dem die Verknüpfung gehört. Legen Sie ein ProductAccount-Objekt fest.

Legen Sie für account_type den AccountType des Werbetreibendenkontos fest.

Legen Sie für account_id die ID des Werbetreibendenkontos fest.

In der Anleitung zu Zielen und Headern finden Sie Informationen zur ID, die für die einzelnen Werbetreibendentypen verwendet werden muss.

partner_account

Gibt das Partnerkonto an. Legen Sie ein ProductAccount-Objekt fest.

Legen Sie für account_type den AccountType des Partnerkontos fest. Wenn die Verknüpfung beispielsweise von einem Werbetreibendenkonto zu einem Datenpartnerkonto erfolgt, legen Sie für dieses Feld DATA_PARTNER fest.

Legen Sie für account_id die ID des Partnerkontos fest.

Anfrage erstellen

Erstellen Sie eine CreatePartnerLinkRequest, um eine Partnerverknüpfung zu erstellen.

1. Legen Sie für parent den Ressourcennamen des Werbetreibendenkontos fest. Verwenden Sie das folgende Format:

   accountTypes/{account_type}/accounts/{account}
   

2. Legen Sie für partner_link die erstellte PartnerLink-Ressource fest.

3. 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 login-account Header wie unter Ziele und Header konfigurieren beschrieben fest.

Hier sind Beispielanfragen im JSON-Format zum Erstellen einer Verknüpfung zu einem Datenpartnerkonto in verschiedenen Arten von Werbetreibendenkonten.

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

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

{
    "owningAccount": {
        "accountType": "DISPLAY_VIDEO_PARTNER",
        "accountId": "INSERT_DISPLAY_VIDEO_PARTNER_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 Anmeldedaten für ein Google-Konto mit Zugriff auf das 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 zu ermitteln. Aktualisieren Sie dann die Anfrage und die Header, um alle Probleme zu beheben, und senden Sie die aktualisierte Anfrage und die Header.

Verknüpfung löschen

Wenn Sie eine PartnerLink-Ressource löschen möchten, senden Sie eine DeletePartnerLinkRequest-Anfrage, bei der name auf den Ressourcennamen festgelegt ist. Legen Sie Header fest, falls erforderlich.