Method: advertisers.lineItems.youtubeAssetTypes.youtubeAssetAssociations.list

Listet die YouTube-Asset-Verknüpfungen auf, die mit der angegebenen Ressource verknüpft sind.

HTTP-Anfrage

GET https://displayvideo.googleapis.com/v4/advertisers/{advertiserId}/lineItems/{linkedEntity.lineItemId}/youtubeAssetTypes/{youtubeAssetType}/youtubeAssetAssociations

Die URL verwendet die Syntax der gRPC-Transcodierung.

Pfadparameter

Parameter
advertiserId

string (int64 format)

Erforderlich. Die ID des Werbetreibenden, zu dem die verknüpfte Einheit gehört.

Union-Parameter entity. Die Entität, die mit dem YouTube-Asset verknüpft werden soll. Für entity ist nur einer der folgenden Werte zulässig:
linkedEntity.lineItemId

string (int64 format)

Die ID einer Position.

youtubeAssetType

enum (YoutubeAssetType)

Erforderlich. Der Typ des YouTube-Assets, das mit der Ressource verknüpft wird.

Suchparameter

Parameter
Union-Parameter entity. Die Entität, die mit dem YouTube-Asset verknüpft werden soll. Für entity ist nur einer der folgenden Werte zulässig:
linkedEntity.adGroupId

string (int64 format)

Die ID einer Anzeigengruppe.

pageSize

integer

Optional. Angeforderte Seitengröße. Muss zwischen 1 und 10000 liegen. Wenn nicht angegeben, wird standardmäßig 100 verwendet. Gibt den Fehlercode INVALID_ARGUMENT zurück, wenn ein ungültiger Wert angegeben wird.

pageToken

string

Optional. Ein Token, das eine Ergebnisseite identifiziert, die der Server liefern soll.

Normalerweise ist dies der Wert von nextPageToken, der vom vorherigen Aufruf der Methode youtubeAssetAssociations.list zurückgegeben wurde. Wenn nicht angegeben, wird die erste Ergebnisseite zurückgegeben.

orderBy

string

Optional. Feld, nach dem die Liste sortiert werden soll.

Die einzigen zulässigen Werte sind:

  • linkedYoutubeAsset.locationAssetFilter.assetSetId,
  • linkedYoutubeAsset.affiliateLocationAssetFilter.assetSetId,
  • linkedYoutubeAsset.sitelinkAsset.assetId

Die Standardsortierreihenfolge ist aufsteigend. Wenn Sie ein Feld absteigend sortieren möchten, sollte das Suffix „desc“ an den Feldnamen angehängt werden. Beispiel: linkedYoutubeAsset.sitelinkAsset.assetId desc.

Anfragetext

Der Anfragetext muss leer sein.

Antworttext

Wenn der Vorgang erfolgreich abgeschlossen wurde, enthält der Antworttext eine Instanz von ListYoutubeAssetAssociationsResponse.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

  • https://www.googleapis.com/auth/display-video

Weitere Informationen finden Sie unter OAuth 2.0 Overview.