Partnerlink erstellen oder löschen

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

Erstellen Sie einen PartnerLink, indem Sie einen CreatePartnerLinkRequest senden.

Anfragetext erstellen

Erstellen Sie eine PartnerLink-Ressource. Hier sind die festzulegenden Felder.

owning_account

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

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

Legen Sie für account_id die 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_account

Identifiziert das Partnerkonto. Legen Sie ein ProductAccount-Objekt fest.

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

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

Erstellen Sie die Anfrage

Wenn Sie einen Partnerlink erstellen möchten, erstellen Sie einen CreatePartnerLinkRequest.

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

    accountTypes/{account_type}/accounts/{account}
    
  2. Legen Sie für partner_link die von Ihnen 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 Header login-account wie 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.

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

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

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.