REST Resource: advertisers.adGroups.youtubeAssetTypes.youtubeAssetAssociations

Ressource: YoutubeAssetAssociation

Eine Verknüpfung zwischen einer Ressource und einem YouTube-Asset.

JSON-Darstellung 
{
  "name": string,
  "youtubeAssetType": enum (YoutubeAssetType),
  "linkedYoutubeAsset": {
    object (LinkedYouTubeAsset)
  }
}
Felder
name

string

ID. Der Ressourcenname der Zuordnung.

Zuordnungen auf Werbebuchungsebene: Das Namensmuster ist advertisers/{advertiserId}/lineItems/{lineItemId}/youtubeAssetTypes/{youtubeAssetType}/youtubeAssetAssociations/{youtubeAssetAssociationId}.

Für Zuordnungen auf Anzeigengruppenebene: Das Namensmuster ist advertisers/{advertiserId}/adGroups/{adGroupId}/youtubeAssetTypes/{youtubeAssetType}/youtubeAssetAssociations/{youtubeAssetAssociationId}.

Bei YOUTUBE_ASSET_TYPE_LOCATION- und YOUTUBE_ASSET_TYPE_AFFILIATE_LOCATION-Verknüpfungen: youtubeAssetAssociationId ist die ID des verknüpften Asset-Sets oder 0, wenn locationMatchingType oder affiliateLocationMatchingType DISABLED ist.

Für YOUTUBE_ASSET_TYPE_SITELINK-Verknüpfungen: youtubeAssetAssociationId ist die ID des verknüpften Sitelink-Assets.
youtubeAssetType

enum (YoutubeAssetType)

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

object (LinkedYouTubeAsset)

Erforderlich. Das mit der Ressource verknüpfte YouTube-Asset.

YoutubeAssetType

Mögliche Arten von YouTube-Assets.

Diese Assets enthalten zusätzliche Informationen, die bei der Anzeigenbereitstellung präsentiert werden.

Enums
YOUTUBE_ASSET_TYPE_UNSPECIFIED Der YouTube-Asset-Typ ist in dieser Version nicht angegeben oder unbekannt.
YOUTUBE_ASSET_TYPE_LOCATION Standort-Asset
YOUTUBE_ASSET_TYPE_AFFILIATE_LOCATION Affiliate-Standort-Asset

LinkedYouTubeAsset

Ein YouTube-Asset, das mit einer Ressource in einem YoutubeAssetAssociation verknüpft ist.

JSON-Darstellung 
{

  // Union field youtube_asset can be only one of the following:
  "locationAssetFilter": {
    object (LocationAssetFilter)
  },
  "affiliateLocationAssetFilter": {
    object (AffiliateLocationAssetFilter)
  },
  "sitelinkAsset": {
    object (SitelinkAsset)
  }
  // End of list of possible types for union field youtube_asset.
}
Felder
Union-Feld youtube_asset. Das YouTube-Asset. Für youtube_asset ist nur einer der folgenden Werte zulässig:
locationAssetFilter

object (LocationAssetFilter)

Ein Filter für Standort-Assets.

Kann nur festgelegt werden, wenn youtubeAssetType gleich YOUTUBE_ASSET_TYPE_LOCATION ist.
affiliateLocationAssetFilter

object (AffiliateLocationAssetFilter)

Ein Filter für Affiliate-Standort-Assets.

Kann nur festgelegt werden, wenn youtubeAssetType gleich YOUTUBE_ASSET_TYPE_AFFILIATE_LOCATION ist.

LocationAssetFilter

Ein Asset-Filter, der mit zulässigen Standort-Assets für die Auslieferung übereinstimmt.

JSON-Darstellung 
{
  "locationMatchingType": enum (LocationMatchingType),
  "assetSetId": string,
  "locationMatchingFunction": {
    object (LocationMatchingFunction)
  }
}
Felder
locationMatchingType

enum (LocationMatchingType)

Erforderlich. Der Abgleichstyp dieses Filters für Standort-Assets.
assetSetId

string (int64 format)

Nur Ausgabe. Die ID des Asset-Satzes, der den für die Bereitstellung infrage kommenden Standort-Assets entspricht.
locationMatchingFunction

object (LocationMatchingFunction)

Optional. Die Abgleichsfunktion, die bestimmt, wie der Filter für Standort-Assets mit Standort-Assets abgeglichen wird.

Dieses Feld ist erforderlich und kann nur festgelegt werden, wenn locationMatchingType FILTER oder SELECTED_ASSETS ist.

LocationMatchingType

Mögliche Abgleichstypen, die darüber entscheiden, welche Standort-Assets für die Auslieferung infrage kommen.

Enums
LOCATION_MATCHING_TYPE_UNSPECIFIED Der Typ der Standortübereinstimmung ist in dieser Version nicht angegeben oder unbekannt.
SELECT_ALL Alle verfügbaren Standort-Assets können ausgeliefert werden.
FILTER Es können Standort-Assets ausgeliefert werden, die mit den angegebenen Filtern für Unternehmensnamen und/oder Labels übereinstimmen.
SELECTED_ASSETS Es können nur die ausgewählten Standort-Assets ausgeliefert werden.
DISABLED Es können keine Standort-Assets ausgeliefert werden.

LocationMatchingFunction

Die Abgleichsfunktion für einen Filter für Standort-Assets.

JSON-Darstellung 
{
  "labels": [
    string
  ],
  "locationAssetIds": [
    string
  ],
  "business": string
}
Felder
labels[]

string

Optional. Das Label, mit dem abgeglichen werden soll.

Labels werden logisch mit ODER verknüpft.

Dieses Feld ist optional und kann nur festgelegt werden, wenn locationMatchingType FILTER ist.
locationAssetIds[]

string (int64 format)

Optional. Die ausgewählten Standort-Asset-IDs.

Dieses Feld ist erforderlich, wenn locationMatchingType SELECTED_ASSETS ist.
business

string

Optional. Der Name des Unternehmens, mit dem abgeglichen werden soll.

Dieses Feld ist optional und kann nur festgelegt werden, wenn locationMatchingType FILTER ist.

AffiliateLocationAssetFilter

Ein Asset-Filter, der mit zulässigen Affiliate-Standort-Assets für die Auslieferung übereinstimmt.

JSON-Darstellung 
{
  "affiliateLocationMatchingType": enum (AffiliateLocationMatchingType),
  "assetSetId": string,
  "affiliateLocationMatchingFunction": {
    object (AffiliateLocationMatchingFunction)
  }
}
Felder
affiliateLocationMatchingType

enum (AffiliateLocationMatchingType)

Erforderlich. Der Abgleichstyp dieses Filters für Affiliate-Standort-Assets.
assetSetId

string (int64 format)

Nur Ausgabe. Die ID des Asset-Satzes, der den Affiliate-Standort-Assets entspricht, die für die Bereitstellung infrage kommen.
affiliateLocationMatchingFunction

object (AffiliateLocationMatchingFunction)

Optional. Die Abgleichsfunktion, die bestimmt, wie der Filter für Affiliate-Standort-Assets mit Affiliate-Standort-Assets übereinstimmt.

Dieses Feld ist erforderlich und kann nur festgelegt werden, wenn affiliateLocationMatchingType SELECTED_CHAINS ist.

AffiliateLocationMatchingType

Mögliche Abgleichstypen, die darüber entscheiden, welche Affiliate-Standort-Assets für die Auslieferung infrage kommen.

Enums
AFFILIATE_LOCATION_MATCHING_TYPE_UNSPECIFIED Der Abgleichstyp für Affiliate-Standorte ist in dieser Version nicht angegeben oder unbekannt.
SELECT_ALL Alle verfügbaren Affiliate-Standort-Assets können ausgeliefert werden.
SELECTED_CHAINS Die ausgewählten Affiliate-Standort-Assets können ausgeliefert werden.
DISABLED Es können keine Affiliate-Standort-Assets ausgeliefert werden.

AffiliateLocationMatchingFunction

Die Abgleichsfunktion für einen Filter für Affiliate-Standort-Assets.

JSON-Darstellung 
{
  "chains": [
    {
      object (AffiliateLocationChain)
    }
  ]
}
Felder
chains[]

object (AffiliateLocationChain)

Optional. Die ausgewählten Affiliate-Standortketten-IDs.

Dieses Feld ist erforderlich, wenn affiliateLocationMatchingType SELECTED_CHAINS ist.

AffiliateLocationChain

Eine Kette von Affiliate-Standorten.

JSON-Darstellung 
{
  "chainId": string
}
Felder
chainId

string (int64 format)

Erforderlich. ID der Affiliate-Standortkette.

SitelinkAsset

Ein Sitelink-Asset.

JSON-Darstellung 
{
  "assetId": string
}
Felder
assetId

string (int64 format)

Erforderlich. Die ID des Sitelink-Assets.

Methoden

create

 Erstellt eine neue Verknüpfung zwischen der identifizierten Ressource und einem YouTube-Asset.

delete

 Löscht eine vorhandene Verknüpfung zwischen der identifizierten Ressource und einem YouTube-Asset.

list

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