Method: accountTypes.accounts.partnerLinks.search

Sucht nach allen Partnerlinks zu und von einem bestimmten Konto.

Autorisierungsheader:

Diese Methode unterstützt die folgenden optionalen Header, um zu definieren, wie der Zugriff für die Anfrage von der API autorisiert wird:

  • login-account: (Optional) Der Ressourcenname des Kontos, bei dem das Google-Konto der Anmeldedaten ein Nutzer ist. Wenn nicht festgelegt, wird standardmäßig das Konto der Anfrage verwendet. Format: accountTypes/{loginAccountType}/accounts/{loginAccountId}

HTTP-Anfrage

GET https://datamanager.googleapis.com/v1/{parent=accountTypes/*/accounts/*}/partnerLinks:search

Die URL verwendet die Syntax der gRPC-Transcodierung.

Pfadparameter

Parameter
parent

string

Erforderlich. Konto, nach dem nach Partnerlinks gesucht werden soll. Wenn kein filter angegeben ist, werden alle Partnerlinks zurückgegeben, bei denen dieses Konto entweder das owningAccount oder partnerAccount ist.

Format: accountTypes/{accountType}/accounts/{account}

Suchparameter

Parameter
pageSize

integer

Die maximale Anzahl der zurückzugebenden Partnerlinks. Der Dienst gibt möglicherweise weniger als diesen Wert zurück. Wenn nicht angegeben, werden maximal 50 Partnerlinks zurückgegeben. Der Höchstwert beträgt 100. Werte über 100 werden implizit auf 100 umgewandelt.

pageToken

string

Ein Seitentoken, das von einem vorherigen partnerLinks.search-Aufruf empfangen wurde. Geben Sie dieses an, um die nachfolgende Seite abzurufen.

Beim Paginieren müssen alle anderen für partnerLinks.search bereitgestellten Parameter mit dem Aufruf übereinstimmen, der das Seitentoken bereitgestellt hat.

filter

string

Optional. Ein Filterstring. Alle Felder müssen auf der linken Seite jeder Bedingung stehen (z. B. partner_link_id = 123456789). Felder müssen entweder im Camel-Case-Format oder im Snake-Case-Format angegeben werden. Verwenden Sie keine Kombination aus Camel-Case- und Snake-Case-Format.

Unterstützte Vorgänge:

  • AND
  • =
  • !=

Unterstützte Felder:

  • partner_link_id
  • owning_account.account_type
  • owning_account.account_id
  • partner_account.account_type
  • partner_account.account_id
  • featureSet

Bei Partnerlinks mit dem Feature-Set FEATURE_SET_AD_EVENT_MANAGEMENT werden auch die folgenden Felder unterstützt:

  • partnerCustomerAccount.account_id
  • partnerLinkMetadata.implicit_accounts.account_id

Beispiel: owning_account.account_type = "GOOGLE_ADS" AND partner_account.account_id = 987654321

Anfragetext

Der Anfragetext muss leer sein.

Antworttext

Antwort von der SearchPartnerLinksRequest.

Bei Erfolg enthält der Antworttext Daten mit der folgenden Struktur:

JSON-Darstellung
{
  "partnerLinks": [
    {
      object (PartnerLink)
    }
  ],
  "nextPageToken": string
}
Felder
nextPageToken

string

Ein Token, das als pageToken gesendet werden kann, um die nächste Seite abzurufen. Wenn dieses Feld weggelassen wird, gibt es keine nachfolgenden Seiten.

Autorisierungsbereiche

Erfordert einen der folgenden OAuth-Bereiche:

  • https://www.googleapis.com/auth/datamanager
  • https://www.googleapis.com/auth/datamanager.partnerlink