REST Resource: advertisers.adGroups.youtubeAssetTypes.youtubeAssetAssociations

Zasób: YoutubeAssetAssociation

Powiązanie między zasobem a zasobem YouTube.

Zapis JSON 
{
  "name": string,
  "youtubeAssetType": enum (YoutubeAssetType),
  "linkedYoutubeAsset": {
    object (LinkedYouTubeAsset)
  }
}
Pola
name

string

Identyfikator. Nazwa zasobu powiązania.

W przypadku powiązań na poziomie elementu zamówienia: wzorzec nazwy to advertisers/{advertiserId}/lineItems/{lineItemId}/youtubeAssetTypes/{youtubeAssetType}/youtubeAssetAssociations/{youtubeAssetAssociationId}.

W przypadku powiązań na poziomie grupy reklam: wzorzec nazwy to advertisers/{advertiserId}/adGroups/{adGroupId}/youtubeAssetTypes/{youtubeAssetType}/youtubeAssetAssociations/{youtubeAssetAssociationId}.

W przypadku powiązań YOUTUBE_ASSET_TYPE_LOCATION i YOUTUBE_ASSET_TYPE_AFFILIATE_LOCATION: youtubeAssetAssociationId to identyfikator połączonego zestawu komponentów lub 0, jeśli locationMatchingType lub affiliateLocationMatchingType ma wartość DISABLED.

W przypadku powiązań YOUTUBE_ASSET_TYPE_SITELINK: youtubeAssetAssociationId to identyfikator połączonego komponentu z linkami do podstron.
youtubeAssetType

enum (YoutubeAssetType)

Wymagane. Typ zasobu YouTube powiązany z zasobem.
linkedYoutubeAsset

object (LinkedYouTubeAsset)

Wymagane. Zasób YouTube powiązany z zasobem.

YoutubeAssetType

Możliwe typy komponentów YouTube.

Podczas wyświetlania reklam komponenty te będą zawierać dodatkowe informacje.

Wartości w polu enum
YOUTUBE_ASSET_TYPE_UNSPECIFIED Typ zasobu w YouTube nie jest określony lub jest nieznany w tej wersji.
YOUTUBE_ASSET_TYPE_LOCATION komponent z lokalizacją,
YOUTUBE_ASSET_TYPE_AFFILIATE_LOCATION Komponent z powiązaną lokalizacją.

LinkedYouTubeAsset

Zasób w YouTube połączony z zasobem w YoutubeAssetAssociation.

Zapis JSON 
{

  // 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.
}
Pola
Pole zbiorcze youtube_asset. zasób YouTube; youtube_asset może mieć tylko jedną z tych wartości:
locationAssetFilter

object (LocationAssetFilter)

Filtr komponentów z lokalizacją.

Można to ustawić tylko wtedy, gdy youtubeAssetType ma wartość YOUTUBE_ASSET_TYPE_LOCATION.
affiliateLocationAssetFilter

object (AffiliateLocationAssetFilter)

Filtr komponentów z powiązaną lokalizacją.

Można to ustawić tylko wtedy, gdy youtubeAssetType ma wartość YOUTUBE_ASSET_TYPE_AFFILIATE_LOCATION.

LocationAssetFilter

filtr komponentów, który pasuje do kwalifikujących się do wyświetlania komponentów z lokalizacją;

Zapis JSON 
{
  "locationMatchingType": enum (LocationMatchingType),
  "assetSetId": string,
  "locationMatchingFunction": {
    object (LocationMatchingFunction)
  }
}
Pola
locationMatchingType

enum (LocationMatchingType)

Wymagane. Typ dopasowania tego filtra komponentu z lokalizacją.
assetSetId

string (int64 format)

Tylko dane wyjściowe. Identyfikator zestawu komponentów, który pasuje do komponentów lokalizacji kwalifikujących się do wyświetlania.
locationMatchingFunction

object (LocationMatchingFunction)

Opcjonalnie: Funkcja dopasowywania, która określa, jak filtr komponentów z lokalizacją dopasowuje komponenty z lokalizacją.

To pole jest wymagane i można je ustawić tylko wtedy, gdy locationMatchingType ma wartość FILTER lub SELECTED_ASSETS.

LocationMatchingType

Możliwe typy dopasowania, które określają, które komponenty lokalizacji kwalifikują się do wyświetlania.

Wartości w polu enum
LOCATION_MATCHING_TYPE_UNSPECIFIED Typ dopasowywania lokalizacji nie jest określony lub jest nieznany w tej wersji.
SELECT_ALL Wszystkie dostępne komponenty z lokalizacją kwalifikują się do wyświetlania.
FILTER Mogą się wyświetlać komponenty lokalizacji, które pasują do podanych filtrów nazwy firmy lub etykiety.
SELECTED_ASSETS Wyświetlane mogą być tylko wybrane komponenty z lokalizacją.
DISABLED Nie można wyświetlać komponentów z lokalizacją.

LocationMatchingFunction

Funkcja dopasowywania filtra komponentu z lokalizacją.

Zapis JSON 
{
  "labels": [
    string
  ],
  "locationAssetIds": [
    string
  ],
  "business": string
}
Pola
labels[]

string

Opcjonalnie: Etykieta do dopasowania.

Etykiety są łączone za pomocą operatora logicznego LUB.

To pole jest opcjonalne i można je ustawić tylko wtedy, gdy locationMatchingType ma wartość FILTER.
locationAssetIds[]

string (int64 format)

Opcjonalnie: Identyfikatory wybranych komponentów z lokalizacją.

To pole jest wymagane, jeśli locationMatchingType ma wartość SELECTED_ASSETS.
business

string

Opcjonalnie: Nazwa firmy, z którą ma być dopasowana.

To pole jest opcjonalne i można je ustawić tylko wtedy, gdy locationMatchingType ma wartość FILTER.

AffiliateLocationAssetFilter

Filtr komponentów, który dopasowuje kwalifikujące się do wyświetlania komponenty z powiązaną lokalizacją.

Zapis JSON 
{
  "affiliateLocationMatchingType": enum (AffiliateLocationMatchingType),
  "assetSetId": string,
  "affiliateLocationMatchingFunction": {
    object (AffiliateLocationMatchingFunction)
  }
}
Pola
affiliateLocationMatchingType

enum (AffiliateLocationMatchingType)

Wymagane. Typ dopasowania tego filtra komponentu z powiązaną lokalizacją.
assetSetId

string (int64 format)

Tylko dane wyjściowe. Identyfikator zestawu komponentów, który pasuje do komponentów z powiązaną lokalizacją kwalifikujących się do wyświetlania.
affiliateLocationMatchingFunction

object (AffiliateLocationMatchingFunction)

Opcjonalnie: Funkcja dopasowywania, która określa, jak filtr komponentu z powiązaną lokalizacją dopasowuje komponenty z powiązaną lokalizacją.

To pole jest wymagane i można je ustawić tylko wtedy, gdy affiliateLocationMatchingType ma wartość SELECTED_CHAINS.

AffiliateLocationMatchingType

Możliwe typy dopasowania, które decydują o tym, które komponenty z powiązaną lokalizacją kwalifikują się do wyświetlania.

Wartości w polu enum
AFFILIATE_LOCATION_MATCHING_TYPE_UNSPECIFIED Typ dopasowania powiązanej lokalizacji nie jest określony lub jest nieznany w tej wersji.
SELECT_ALL Wszystkie dostępne komponenty z powiązaną lokalizacją kwalifikują się do wyświetlania.
SELECTED_CHAINS Wybrane komponenty z powiązaną lokalizacją mogą się wyświetlać.
DISABLED Nie można wyświetlać komponentów z powiązaną lokalizacją.

AffiliateLocationMatchingFunction

Funkcja dopasowania filtra komponentu z powiązaną lokalizacją.

Zapis JSON 
{
  "chains": [
    {
      object (AffiliateLocationChain)
    }
  ]
}
Pola
chains[]

object (AffiliateLocationChain)

Opcjonalnie: Wybrane identyfikatory sieci powiązanych lokalizacji.

To pole jest wymagane, jeśli affiliateLocationMatchingType ma wartość SELECTED_CHAINS.

AffiliateLocationChain

Sieć powiązanych lokalizacji.

Zapis JSON 
{
  "chainId": string
}
Pola
chainId

string (int64 format)

Wymagane. Identyfikator powiązanej sieci lokalizacji.

SitelinkAsset

komponent z linkami do podstron;

Zapis JSON 
{
  "assetId": string
}
Pola
assetId

string (int64 format)

Wymagane. Identyfikator komponentu z linkami do podstron.

Metody

create

 Tworzy nowe powiązanie między zidentyfikowanym zasobem a komponentem YouTube.

delete

 Usuwa istniejące powiązanie między zidentyfikowanym zasobem a komponentem YouTube.

list

 Wyświetla listę powiązań zasobów YouTube z podanym zasobem.