Asset

Komponent reklamy to element reklamy, który można udostępniać w wielu reklamach. Może to być obraz (ImageAsset), film (YoutubeVideoAsset) itp. Zasoby są niezmienne i nie można ich usunąć. Aby zatrzymać wyświetlanie komponentu, usuń go z elementu, który go używa.

Zapis JSON 
{
  "resourceName": string,
  "type": enum (AssetType),
  "finalUrls": [
    string
  ],
  "finalMobileUrls": [
    string
  ],
  "urlCustomParameters": [
    {
      object (CustomParameter)
    }
  ],
  "source": enum (AssetSource),
  "policySummary": {
    object (AssetPolicySummary)
  },
  "fieldTypePolicySummaries": [
    {
      object (AssetFieldTypePolicySummary)
    }
  ],
  "id": string,
  "name": string,
  "trackingUrlTemplate": string,
  "finalUrlSuffix": string,

  // Union field asset_data can be only one of the following:
  "youtubeVideoAsset": {
    object (YoutubeVideoAsset)
  },
  "mediaBundleAsset": {
    object (MediaBundleAsset)
  },
  "imageAsset": {
    object (ImageAsset)
  },
  "textAsset": {
    object (TextAsset)
  },
  "leadFormAsset": {
    object (LeadFormAsset)
  },
  "bookOnGoogleAsset": {
    object (BookOnGoogleAsset)
  },
  "promotionAsset": {
    object (PromotionAsset)
  },
  "calloutAsset": {
    object (CalloutAsset)
  },
  "structuredSnippetAsset": {
    object (StructuredSnippetAsset)
  },
  "sitelinkAsset": {
    object (SitelinkAsset)
  },
  "pageFeedAsset": {
    object (PageFeedAsset)
  },
  "dynamicEducationAsset": {
    object (DynamicEducationAsset)
  },
  "mobileAppAsset": {
    object (MobileAppAsset)
  },
  "hotelCalloutAsset": {
    object (HotelCalloutAsset)
  },
  "callAsset": {
    object (CallAsset)
  },
  "priceAsset": {
    object (PriceAsset)
  },
  "callToActionAsset": {
    object (CallToActionAsset)
  },
  "dynamicRealEstateAsset": {
    object (DynamicRealEstateAsset)
  },
  "dynamicCustomAsset": {
    object (DynamicCustomAsset)
  },
  "dynamicHotelsAndRentalsAsset": {
    object (DynamicHotelsAndRentalsAsset)
  },
  "dynamicFlightsAsset": {
    object (DynamicFlightsAsset)
  },
  "demandGenCarouselCardAsset": {
    object (DemandGenCarouselCardAsset)
  },
  "dynamicTravelAsset": {
    object (DynamicTravelAsset)
  },
  "dynamicLocalAsset": {
    object (DynamicLocalAsset)
  },
  "dynamicJobsAsset": {
    object (DynamicJobsAsset)
  },
  "locationAsset": {
    object (LocationAsset)
  },
  "hotelPropertyAsset": {
    object (HotelPropertyAsset)
  },
  "businessMessageAsset": {
    object (BusinessMessageAsset)
  },
  "appDeepLinkAsset": {
    object (AppDeepLinkAsset)
  }
  // End of list of possible types for union field asset_data.
}
Pola
resourceName

string

Niezmienna. Nazwa zasobu. Nazwy zasobów komponentów mają postać:

customers/{customerId}/assets/{assetId}
type

enum (AssetType)

Tylko dane wyjściowe. Typ zasobu.
finalUrls[]

string

Lista możliwych końcowych adresów URL po wszystkich przekierowaniach między domenami.
finalMobileUrls[]

string

Lista możliwych końcowych adresów URL na urządzenia mobilne po wszystkich przekierowaniach między domenami.
urlCustomParameters[]

object (CustomParameter)

Lista mapowań służących do zastępowania tagów parametru niestandardowego w adresie URL w elementach trackingUrlTemplate, finalUrls lub finalMobileUrls.
source

enum (AssetSource)

Tylko dane wyjściowe. Źródło komponentu.
policySummary

object (AssetPolicySummary)

Tylko dane wyjściowe. Informacje o zasadach dotyczących zasobu.
fieldTypePolicySummaries[]

object (AssetFieldTypePolicySummary)

Tylko dane wyjściowe. Informacje o zasadach dotyczących zasobu dla każdego typu pola.
id

string (int64 format)

Tylko dane wyjściowe. Identyfikator zasobu.
name

string

Opcjonalna nazwa zasobu.
trackingUrlTemplate

string

Szablon adresu URL do tworzenia linku monitorującego.
finalUrlSuffix

string

Szablon URL służący do dołączania parametrów do adresów URL stron docelowych wyświetlanych z użyciem śledzenia równoległego.
Pole unii asset_data. Konkretny typ komponentu. asset_data może być tylko jednym z tych elementów:
youtubeVideoAsset

object (YoutubeVideoAsset)

Niezmienna. Komponent wideo w YouTube.
mediaBundleAsset

object (MediaBundleAsset)

Niezmienna. Zasób pakietu kreacji multimedialnych.
imageAsset

object (ImageAsset)

Tylko dane wyjściowe. Komponent z obrazem.
textAsset

object (TextAsset)

Niezmienna. Komponent tekstowy.
leadFormAsset

object (LeadFormAsset)

Komponent z formularzem kontaktowym.
bookOnGoogleAsset

object (BookOnGoogleAsset)

Zasób Zarezerwuj z Google.
promotionAsset

object (PromotionAsset)

Komponent z promocją.
calloutAsset

object (CalloutAsset)

Komponent z objaśnieniem.
structuredSnippetAsset

object (StructuredSnippetAsset)

Komponent z rozszerzeniem informacji.
pageFeedAsset

object (PageFeedAsset)

Plik z adresami stron docelowych.
dynamicEducationAsset

object (DynamicEducationAsset)

Dynamiczny zasób edukacyjny
mobileAppAsset

object (MobileAppAsset)

Komponent aplikacji mobilnej.
hotelCalloutAsset

object (HotelCalloutAsset)

Komponent z objaśnieniem dotyczącym hoteli.
callAsset

object (CallAsset)

Komponent do wykonywania połączeń.
priceAsset

object (PriceAsset)

Komponent z cenami.
callToActionAsset

object (CallToActionAsset)

Niezmienna. Komponent z wezwaniem do działania.
dynamicRealEstateAsset

object (DynamicRealEstateAsset)

Dynamiczny zasób dotyczący nieruchomości.
dynamicCustomAsset

object (DynamicCustomAsset)

Dynamiczny komponent niestandardowy.
dynamicHotelsAndRentalsAsset

object (DynamicHotelsAndRentalsAsset)

Zasób dynamiczny związany z hotelami i wynajmem.
dynamicFlightsAsset

object (DynamicFlightsAsset)

Dynamiczny komponent dotyczący lotów.
dynamicTravelAsset

object (DynamicTravelAsset)

Dynamiczny zasób dotyczący podróży.
dynamicLocalAsset

object (DynamicLocalAsset)

Dynamiczny komponent dotyczący produktu dostępnego lokalnie.
dynamicJobsAsset

object (DynamicJobsAsset)

Dynamiczny zasób dotyczący zadań.
locationAsset

object (LocationAsset)

Tylko dane wyjściowe. Komponent z lokalizacją.
hotelPropertyAsset

object (HotelPropertyAsset)

Niezmienna. Zasób obiektu hotelowego.
businessMessageAsset

object (BusinessMessageAsset)

Komponent do wysyłania wiadomości do firmy.

Typ komponentu

Wyliczenie opisujące możliwe typy komponentów.

Wartości w polu enum
UNSPECIFIED Nie określono.
UNKNOWN Służy tylko do zwracania wartości. Reprezentuje wartość nieznana w tej wersji.
YOUTUBE_VIDEO Komponent wideo w YouTube.
MEDIA_BUNDLE Zasób pakietu kreacji multimedialnych.
IMAGE Komponent z obrazem.
TEXT Komponent tekstowy.
LEAD_FORM Komponent z formularzem kontaktowym.
BOOK_ON_GOOGLE Zasób Zarezerwuj z Google.
PROMOTION Komponent z promocją.
CALLOUT Komponent z objaśnieniem.
STRUCTURED_SNIPPET Komponent z rozszerzeniem informacji.
PAGE_FEED Plik z adresami stron docelowych.
DYNAMIC_EDUCATION Dynamiczny komponent edukacyjny.
MOBILE_APP Komponent aplikacji mobilnej.
HOTEL_CALLOUT Komponent z objaśnieniem dotyczącym hoteli.
CALL Komponent do wykonywania połączeń.
PRICE Komponent z cenami.
CALL_TO_ACTION Komponent z wezwaniem do działania.
DYNAMIC_REAL_ESTATE Dynamiczny komponent dotyczący nieruchomości
DYNAMIC_CUSTOM Dynamiczny zasób niestandardowy.
DYNAMIC_HOTELS_AND_RENTALS Zasób dynamiczny dotyczący hoteli i wynajmu.
DYNAMIC_FLIGHTS Dynamiczny komponent dotyczący lotów.
DYNAMIC_TRAVEL Dynamiczny komponent dotyczący podróży.
DYNAMIC_LOCAL Dynamiczny komponent dotyczący produktu dostępnego lokalnie.
DYNAMIC_JOBS Dynamiczny komponent dotyczący zadań
LOCATION Komponent z lokalizacją.
HOTEL_PROPERTY Zasób hotelu.
BUSINESS_MESSAGE Komponent do wysyłania wiadomości do firmy.

AssetPolicySummary

Zawiera informacje o zasadach dotyczących zasobu.

Zapis JSON 
{
  "policyTopicEntries": [
    {
      object (PolicyTopicEntry)
    }
  ],
  "reviewStatus": enum (PolicyReviewStatus),
  "approvalStatus": enum (PolicyApprovalStatus)
}
Pola
policyTopicEntries[]

object (PolicyTopicEntry)

Tylko dane wyjściowe. Lista wyników kontroli zgodności z zasadami dotyczących tego zasobu.
reviewStatus

enum (PolicyReviewStatus)

Tylko dane wyjściowe. W jakim miejscu w procesie weryfikacji znajduje się ten komponent.
approvalStatus

enum (PolicyApprovalStatus)

Tylko dane wyjściowe. Ogólny stan zatwierdzenia tego komponentu, obliczony na podstawie stanu poszczególnych wpisów dotyczących tematu zasad.

AssetFieldTypePolicySummary

Zawiera informacje o zasadach dotyczących zasobu w kontekście typu pola komponentu.

Zapis JSON 
{
  "assetFieldType": enum (AssetFieldType),
  "assetSource": enum (AssetSource),
  "policySummaryInfo": {
    object (AssetPolicySummary)
  }
}
Pola
assetFieldType

enum (AssetFieldType)

Tylko dane wyjściowe. Typ pola tego komponentu.
assetSource

enum (AssetSource)

Tylko dane wyjściowe. Źródło tego komponentu.
policySummaryInfo

object (AssetPolicySummary)

Tylko dane wyjściowe. Podsumowanie zasad.

YoutubeVideoAsset

Zasób YouTube.

Zapis JSON 
{
  "youtubeVideoTitle": string,
  "youtubeVideoId": string
}
Pola
youtubeVideoTitle

string

Tytuł filmu w YouTube.
youtubeVideoId

string

Identyfikator filmu w YouTube. To 11-znakowy ciąg znaków używany w adresie URL filmu w YouTube.

MediaBundleAsset

Zasób MediaBundle.

Zapis JSON 
{
  "data": string
}
Pola
data

string (bytes format)

Dane komponentu pakietu kreacji multimedialnych (plik ZIP). Format przesłanego pliku ZIP zależy od pola reklamy, w którym będzie on używany. Więcej informacji o tym formacie znajdziesz w dokumentacji dotyczącej pola reklamy, w którym planujesz użyć zasobu MediaBundleAsset. To pole służy tylko do modyfikacji.

Ciąg znaków zakodowany w formacie Base64.

ImageAsset

Komponent z obrazem.

Zapis JSON 
{
  "mimeType": enum (MimeType),
  "fullSize": {
    object (ImageDimension)
  },
  "data": string,
  "fileSize": string
}
Pola
mimeType

enum (MimeType)

Typ MIME komponentu z obrazem.
fullSize

object (ImageDimension)

Metadane tego obrazu w jego pierwotnym rozmiarze.
data

string (bytes format)

Nieprzetworzone bajty danych obrazu. To pole służy tylko do modyfikacji.

Ciąg znaków zakodowany w formacie Base64.
fileSize

string (int64 format)

Rozmiar pliku zasobu obrazu w bajtach.

ImageDimension

metadane obrazu o określonym rozmiarze, oryginalnym lub zmienionym;

Zapis JSON 
{
  "heightPixels": string,
  "widthPixels": string,
  "url": string
}
Pola
heightPixels

string (int64 format)

Wysokość obrazu.
widthPixels

string (int64 format)

Szerokość obrazu.
url

string

Adres URL z obrazem o tej wysokości i szerokości.

TextAsset

Komponent tekstowy.

Zapis JSON 
{
  "text": string
}
Pola
text

string

Zawartość tekstowa komponentu tekstowego.

LeadFormAsset

Komponent z formularzem kontaktowym.

Zapis JSON 
{
  "businessName": string,
  "callToActionType": enum (LeadFormCallToActionType),
  "callToActionDescription": string,
  "headline": string,
  "description": string,
  "privacyPolicyUrl": string,
  "fields": [
    {
      object (LeadFormField)
    }
  ],
  "customQuestionFields": [
    {
      object (LeadFormCustomQuestionField)
    }
  ],
  "deliveryMethods": [
    {
      object (LeadFormDeliveryMethod)
    }
  ],
  "postSubmitCallToActionType": enum (LeadFormPostSubmitCallToActionType),
  "desiredIntent": enum (LeadFormDesiredIntent),
  "postSubmitHeadline": string,
  "postSubmitDescription": string,
  "backgroundImageAsset": string,
  "customDisclosure": string
}
Pola
businessName

string

Wymagane. Nazwa reklamowanej firmy.
callToActionType

enum (LeadFormCallToActionType)

Wymagane. Wstępnie zdefiniowany tekst wyświetlania, który zachęca użytkownika do rozwinięcia formularza.
callToActionDescription

string

Wymagane. Tekst przedstawiający wyraźną propozycję wartości, czyli to, czego użytkownicy mogą oczekiwać po rozwinięciu formularza.
headline

string

Wymagane. Nagłówek rozwiniętego formularza, który opisuje, o co prosi formularz lub co umożliwia.
description

string

Wymagane. szczegółowy opis rozwiniętego formularza, który opisuje, czego dotyczy i co umożliwia;
privacyPolicyUrl

string

Wymagane. Link do strony opisującej zasady postępowania z danymi zebranymi przez reklamodawcę lub firmę.
fields[]

object (LeadFormField)

Uporządkowana lista pól wejściowych. To pole możesz zaktualizować, zmieniając kolejność pytań, ale nie dodając ani nie usuwając pytań.
customQuestionFields[]

object (LeadFormCustomQuestionField)

Uporządkowana lista pól pytań niestandardowych. W tym polu możesz umieścić maksymalnie 5 pytań kwalifikujących na formularz.
deliveryMethods[]

object (LeadFormDeliveryMethod)

Skonfigurowane metody przesyłania danych potencjalnych klientów do reklamodawcy. Można skonfigurować tylko jedną metodę typu WebhookDelivery.
postSubmitCallToActionType

enum (LeadFormPostSubmitCallToActionType)

Wstępnie zdefiniowany tekst wyświetlany, który zachęca użytkownika do działania po przesłaniu formularza.
desiredIntent

enum (LeadFormDesiredIntent)

Wybrany cel formularza kontaktowego, np. większa liczba potencjalnych klientów lub większa liczba zakwalifikowanych.
postSubmitHeadline

string

Nagłówek tekstu wyświetlany po przesłaniu formularza, który opisuje, jak reklamodawca będzie kontaktować się z użytkownikiem.
postSubmitDescription

string

Szczegółowy opis wyświetlany po przesłaniu formularza, który opisuje, jak reklamodawca skontaktuje się z użytkownikiem.
backgroundImageAsset

string

Nazwa zasobu obrazu tła. Wymiary obrazu muszą wynosić dokładnie 1200 x 628.
customDisclosure

string

Niestandardowe wyłączenie odpowiedzialności wyświetlane razem z wyłączeniem odpowiedzialności Google w formularzu kontaktowym. Dostępny tylko dla wybranych klientów.

LeadFormCallToActionType

Wyliczenie opisujące typy wezwań do działania w formularzu kontaktowym.

Wartości w polu enum
UNSPECIFIED Nie określono.
UNKNOWN Służy tylko do zwracania wartości. Reprezentuje wartość nieznana w tej wersji.
LEARN_MORE Więcej informacji
GET_QUOTE Uzyskaj wycenę.
APPLY_NOW Zgłoś się teraz.
SIGN_UP Zarejestruj się.
CONTACT_US Skontaktuj się z nami.
SUBSCRIBE Subskrybuj.
DOWNLOAD Pobierz.
BOOK_NOW Zarezerwuj teraz.
GET_OFFER Skorzystaj z oferty.
REGISTER Zarejestruj się.
GET_INFO Uzyskaj informacje.
REQUEST_DEMO Poproś o wersję demonstracyjną.
JOIN_NOW Dołącz teraz.
GET_STARTED Zaczynamy

LeadFormField

Jedno pole formularza w formie.

Zapis JSON 
{
  "inputType": enum (LeadFormFieldUserInputType),

  // Union field answers can be only one of the following:
  "singleChoiceAnswers": {
    object (LeadFormSingleChoiceAnswers)
  },
  "hasLocationAnswer": boolean
  // End of list of possible types for union field answers.
}
Pola
inputType

enum (LeadFormFieldUserInputType)

Opisuje typ danych wejściowych, który może być zdefiniowany wstępnie, np. „imię i nazwisko” lub wstępnie sprawdzone pytanie, np. „Jakiego typu jest Twój pojazd?”.
Pole unii answers. Określa konfigurację odpowiedzi akceptowaną przez to pole formularza. Jeśli nie jest ustawione, jest to odpowiedź w formie dowolnego tekstu. answers może być tylko jednym z tych elementów:
singleChoiceAnswers

object (LeadFormSingleChoiceAnswers)

Konfiguracja odpowiedzi na pytanie jednokrotnego wyboru. Można go ustawić tylko w przypadku sprawdzonych wcześniej pól pytań. Wymagane jest podanie co najmniej 2 odpowiedzi, a maksymalnie 12.
hasLocationAnswer

boolean

Konfiguracja odpowiedzi na pytanie dotyczące lokalizacji. Jeśli to pole ma wartość true, w formularzu kontaktowym będą renderowane dane o lokalizacji na poziomie konta lub kampanii (stan, miasto, nazwa firmy itp.). Od wersji 13.1 parametr hasLocationAnswer można ustawiać tylko w przypadku pytania „Jaki jest Twój preferowany salon sprzedaży?” w przypadku reklamodawców, którzy skonfigurowali komponenty z lokalizacją na poziomie kampanii lub konta.

LeadFormSingleChoiceAnswers

Określa możliwe odpowiedzi na pytanie jednokrotnego wyboru, zwykle jako lista rozwijana z jednym wyborem.

Zapis JSON 
{
  "answers": [
    string
  ]
}
Pola
answers[]

string

Lista opcji w pojedynczym polu pytania. Kolejność wpisów określa kolejność w interfejsie. Wymagane jest podanie co najmniej 2 odpowiedzi, a maksymalnie 12.

LeadFormCustomQuestionField

1 występowanie pola niestandardowego w formularzu.

Zapis JSON 
{
  "customQuestionText": string,

  // Union field answers can be only one of the following:
  "singleChoiceAnswers": {
    object (LeadFormSingleChoiceAnswers)
  },
  "hasLocationAnswer": boolean
  // End of list of possible types for union field answers.
}
Pola
customQuestionText

string

Dokładny tekst pola niestandardowego pytania (np. „Jaki masz pojazd?”).
Pole unii answers. Określa konfigurację odpowiedzi akceptowaną przez to pole formularza. Jeśli nie jest ustawione, jest to odpowiedź w formie dowolnego tekstu. answers może być tylko jednym z tych elementów:
singleChoiceAnswers

object (LeadFormSingleChoiceAnswers)

Konfiguracja odpowiedzi na pytanie jednokrotnego wyboru. Odpowiedzi może być od 2 do 12.
hasLocationAnswer

boolean

Konfiguracja odpowiedzi na pytanie dotyczące lokalizacji. Jeśli to pole ma wartość true, w formularzu kontaktowym będą renderowane dane o lokalizacji na poziomie konta lub kampanii (stan, miasto, nazwa firmy itp.). Od wersji 13.1 parametr hasLocationAnswer można ustawiać tylko w przypadku pytania „Jaki jest Twój preferowany salon sprzedaży?” w przypadku reklamodawców, którzy skonfigurowali komponenty z lokalizacją na poziomie kampanii lub konta.

LeadFormDeliveryMethod

Konfiguracja sposobu dostarczania potencjalnych klientów do reklamodawcy.

Zapis JSON 
{

  // Union field delivery_details can be only one of the following:
  "webhook": {
    object (WebhookDelivery)
  }
  // End of list of possible types for union field delivery_details.
}
Pola
Pole unii delivery_details. różne podtypy dostawy. delivery_details może być tylko jednym z tych elementów:
webhook

object (WebhookDelivery)

Metoda wyświetlania za pomocą webhooka.

WebhookDelivery

Google powiadamia reklamodawcę o potencjalnych klientach, wysyłając żądania HTTP do określonego przez niego punktu końcowego. Żądania zawierają dane w formacie JSON zgodnym ze schematem opublikowanym przez Google w ramach dokumentacji reklam w formularzach.

Zapis JSON 
{
  "advertiserWebhookUrl": string,
  "googleSecret": string,
  "payloadSchemaVersion": string
}
Pola
advertiserWebhookUrl

string

Adres URL webhooka podany przez reklamodawcę do wysyłania potencjalnych klientów.
googleSecret

string

Tajny klucz zapobiegający podszywania się nadrzędnego, ustawiony przez reklamodawcę w ramach danych webhooka.
payloadSchemaVersion

string (int64 format)

Wersja schematu, której będzie używać ta instancja dostawy.

LeadFormPostSubmitCallToActionType

Typ wezwania do działania po przesłaniu w formularzu kontaktowym.

Wartości w polu enum
UNSPECIFIED Nie określono.
UNKNOWN Służy tylko do zwracania wartości. Reprezentuje wartość nieznana w tej wersji.
VISIT_SITE Otwórz stronę.
DOWNLOAD Pobierz.
LEARN_MORE Więcej informacji
SHOP_NOW Kup teraz.

LeadFormDesiredIntent

Typ enumeracji opisujący wybrany poziom zamiaru wygenerowanych potencjalnych klientów.

Wartości w polu enum
UNSPECIFIED Nie określono.
UNKNOWN Służy tylko do zwracania wartości. Reprezentuje wartość nieznana w tej wersji.
LOW_INTENT uzyskiwać więcej potencjalnych klientów o potencjalnie niższej jakości.
HIGH_INTENT dostarczać potencjalnych klientów, którzy są lepiej dopasowani;

BookOnGoogleAsset

Ten typ nie ma pól.

Zasób Zarezerwuj z Google. Służy do przekierowywania użytkownika do rezerwacji w Google. Rezerwacja w Google zmieni adres URL przekierowania na rezerwację bezpośrednio w Google.

PromotionAsset

Komponent z promocją.

Zapis JSON 
{
  "promotionTarget": string,
  "discountModifier": enum (PromotionExtensionDiscountModifier),
  "redemptionStartDate": string,
  "redemptionEndDate": string,
  "occasion": enum (PromotionExtensionOccasion),
  "languageCode": string,
  "startDate": string,
  "endDate": string,
  "adScheduleTargets": [
    {
      object (AdScheduleInfo)
    }
  ],

  // Union field discount_type can be only one of the following:
  "percentOff": string,
  "moneyAmountOff": {
    object (Money)
  }
  // End of list of possible types for union field discount_type.

  // Union field promotion_trigger can be only one of the following:
  "promotionCode": string,
  "ordersOverAmount": {
    object (Money)
  }
  // End of list of possible types for union field promotion_trigger.
}
Pola
promotionTarget

string

Wymagane. Opis w dowolnej formie tego, na co jest kierowana promocja.
discountModifier

enum (PromotionExtensionDiscountModifier)

Modyfikator określający warunki rabatu.
redemptionStartDate

string

Data rozpoczęcia okresu, w którym można wykorzystać promocję, w formacie rrrr-MM-dd.
redemptionEndDate

string

Ostatnia data, do której można wykorzystać promocję, w formacie rrrr-MM-dd.
occasion

enum (PromotionExtensionOccasion)

Okazja, z którą jest powiązana promocja. Jeśli ustawisz okazję, okres wykorzystania musi mieścić się w zakresie dat powiązanych z tę okazją.
languageCode

string

Język promocji. Reprezentuje tag języka zgodny ze standardem BCP 47.
startDate

string

Data rozpoczęcia obowiązywania tego zasobu i możliwości jego wyświetlania w formacie rrrr-MM-dd.
endDate

string

Ostatnia data, do której ten zasób jest aktywny i nadal wyświetlany, w formacie rrrr-MM-dd.
adScheduleTargets[]

object (AdScheduleInfo)

Lista nienakładających się harmonogramów określająca wszystkie przedziały czasu, w których zasób może się wyświetlać. W przypadku każdego dnia można utworzyć maksymalnie 6 harmonogramów, czyli łącznie 42 harmonogramy.
Pole unii discount_type. Typ rabatu, może być procentowy lub kwotowy. discount_type może mieć tylko jedną z tych wartości:
percentOff

string (int64 format)

Rabat procentowy w ramach promocji. 1 000 000 = 100%. Wymagana jest albo ta właściwość, albo moneyAmountOff.
moneyAmountOff

object (Money)

Kwota rabatu w ramach promocji. Wymagana jest albo ta właściwość, albo percentOff.
Pole unii promotion_trigger. Reguła powodująca wyświetlenie promocji. Może to być kod promocyjny lub promocja według kwoty zamówienia. promotion_trigger może być tylko jednym z tych elementów:
promotionCode

string

Kod, którego użytkownik powinien użyć, aby kwalifikować się do promocji.
ordersOverAmount

object (Money)

Kwota, jaką musi wynosić łączna wartość zamówienia, aby użytkownik kwalifikował się do promocji.

PromotionExtensionDiscountModifier

Modyfikator rabatów w rozszerzeniu promocji.

Wartości w polu enum
UNSPECIFIED Nie określono.
UNKNOWN Służy tylko do zwracania wartości. Reprezentuje wartość nieznana w tej wersji.
UP_TO „Do”.

PromotionExtensionOccasion

Okazja w rozszerzeniu promocji.

Wartości w polu enum
UNSPECIFIED Nie określono.
UNKNOWN Służy tylko do zwracania wartości. Reprezentuje wartość nieznana w tej wersji.
NEW_YEARS Nowy Rok.
CHINESE_NEW_YEAR Chiński Nowy Rok
VALENTINES_DAY Walentynki.
EASTER Wielkanoc.
MOTHERS_DAY Dzień Matki.
FATHERS_DAY Dzień Ojca.
LABOR_DAY Święto Pracy.
BACK_TO_SCHOOL Powrót do szkoły.
HALLOWEEN Halloween.
BLACK_FRIDAY Czarny Piątek.
CYBER_MONDAY Cyberponiedziałek.
CHRISTMAS Boże Narodzenie
BOXING_DAY Drugi dzień świąt Bożego Narodzenia.
INDEPENDENCE_DAY Dzień Niepodległości w dowolnym kraju.
NATIONAL_DAY Dzień Narodowy w dowolnym kraju.
END_OF_SEASON koniec dowolnego sezonu.
WINTER_SALE Zimowa wyprzedaż.
SUMMER_SALE Letnia wyprzedaż.
FALL_SALE Jesienna wyprzedaż.
SPRING_SALE Wiosenna wyprzedaż.
RAMADAN Ramadan.
EID_AL_FITR Eid al-Fitr.
EID_AL_ADHA Id al-Adha.
SINGLES_DAY Dzień Singla.
WOMENS_DAY Dzień Kobiet.
HOLI Holi.
PARENTS_DAY Dzień Rodziców.
ST_NICHOLAS_DAY Mikołajki.
CARNIVAL Karnawał.
EPIPHANY Dzień Trzech Króli.
ROSH_HASHANAH Rosz ha-Szana.
PASSOVER Pascha.
HANUKKAH Chanuka.
DIWALI Diwali.
NAVRATRI Nawaratri.
SONGKRAN Dostępne w języku tajskim: Songkran.
YEAR_END_GIFT Dostępne w języku japońskim: Prezent na koniec roku.

Pieniądze

Reprezentuje cenę w określonej walucie.

Zapis JSON 
{
  "currencyCode": string,
  "amountMicros": string
}
Pola
currencyCode

string

Trzyliterowy kod waluty w formacie ISO 4217.
amountMicros

string (int64 format)

Kwota wyrażona w wartości mikro. 1 milion to 1 jednostka.

CalloutAsset

Komponent z objaśnieniem.

Zapis JSON 
{
  "calloutText": string,
  "startDate": string,
  "endDate": string,
  "adScheduleTargets": [
    {
      object (AdScheduleInfo)
    }
  ]
}
Pola
calloutText

string

Wymagane. Tekst objaśnienia. Długość tego ciągu powinna mieścić się w zakresie od 1 do 25 znaków.
startDate

string

Data rozpoczęcia obowiązywania tego zasobu i możliwości jego wyświetlania w formacie rrrr-MM-dd.
endDate

string

Ostatnia data, do której ten zasób jest aktywny i nadal wyświetlany, w formacie rrrr-MM-dd.
adScheduleTargets[]

object (AdScheduleInfo)

Lista nienakładających się harmonogramów określająca wszystkie przedziały czasu, w których zasób może się wyświetlać. W przypadku każdego dnia można utworzyć maksymalnie 6 harmonogramów, czyli łącznie 42 harmonogramy.

StructuredSnippetAsset

Komponent z rozszerzeniem informacji.

Zapis JSON 
{
  "header": string,
  "values": [
    string
  ]
}
Pola
header

string

Wymagane. Nagłówek fragmentu. Ten ciąg znaków powinien być jedną z wstępnie zdefiniowanych wartości na stronie https://developers.google.com/google-ads/api/reference/data/structured-snippet-headers
values[]

string

Wymagane. wartości w rozszerzeniu, Rozmiar tej kolekcji powinien mieścić się w zakresie od 3 do 10 włącznie. Długość każdej wartości powinna zawierać się w zakresie od 1 do 25 znaków (włącznie).

SitelinkAsset

Komponent z linkami do podstron.

Zapis JSON 
{
  "linkText": string,
  "description1": string,
  "description2": string,
  "startDate": string,
  "endDate": string,
  "adScheduleTargets": [
    {
      object (AdScheduleInfo)
    }
  ]
}
Pola
linkText

string

Wymagane. Tekst wyświetlany w adresie URL linku do podstrony. Długość tego ciągu powinna mieścić się w zakresie od 1 do 25 znaków.
description1

string

Pierwszy wiersz tekstu reklamy w linku do podstrony. Jeśli jest ustawiona, jej długość powinna mieścić się w przedziale od 1 do 35 znaków (włącznie). Należy też ustawić description2.
description2

string

Drugi wiersz tekstu reklamy w linku do podstrony. Jeśli jest ustawiona, jej długość powinna mieścić się w przedziale od 1 do 35 znaków (włącznie). Należy też ustawić parametr description1.
startDate

string

Data rozpoczęcia obowiązywania tego zasobu i możliwości jego wyświetlania w formacie rrrr-MM-dd.
endDate

string

Ostatnia data, do której ten zasób jest aktywny i nadal wyświetlany, w formacie rrrr-MM-dd.
adScheduleTargets[]

object (AdScheduleInfo)

Lista nienakładających się harmonogramów określająca wszystkie przedziały czasu, w których zasób może się wyświetlać. W przypadku każdego dnia można utworzyć maksymalnie 6 harmonogramów, czyli łącznie 42 harmonogramy.

PageFeedAsset

Plik z adresami stron docelowych.

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

string

Wymagane. Strona internetowa, na którą reklamodawcy chcą kierować reklamy.
labels[]

string

Etykiety służące do grupowania adresów URL stron.

DynamicEducationAsset

Dynamiczny komponent edukacyjny.

Zapis JSON 
{
  "programId": string,
  "locationId": string,
  "programName": string,
  "subject": string,
  "programDescription": string,
  "schoolName": string,
  "address": string,
  "contextualKeywords": [
    string
  ],
  "androidAppLink": string,
  "similarProgramIds": [
    string
  ],
  "iosAppLink": string,
  "iosAppStoreId": string,
  "thumbnailImageUrl": string,
  "imageUrl": string
}
Pola
programId

string

Wymagane. Identyfikator programu, który może być dowolną sekwencją liter i cyfr. Musi być niepowtarzalny i odpowiadać wartościom tagu remarketingowego. Wymagane.
locationId

string

Identyfikator lokalizacji, który może być dowolną sekwencją liter i cyfr i musi być niepowtarzalny.
programName

string

Wymagane. Nazwa programu, np. Pielęgniarstwo. Wymagane.
subject

string

Temat badań, np. zdrowie.
programDescription

string

Opis programu, na przykład dyplom pielęgniarski.
schoolName

string

Nazwa szkoły, np. Mountain View School of Nursing.
address

string

Adres szkoły, który może być podany w jednym z tych formatów: (1) Miasto, województwo, kod, kraj, np. Mountain View, CA, USA. (2) Pełny adres, np. ul. Środkowa 123, 00-018 Warszawa. (3) szerokość i długość geograficzna w formacie DDD, np. 41.40338, 2.17403
contextualKeywords[]

string

kontekstowych słów kluczowych, np. dyplom pielęgniarski, zdrowie, Mountain View;
similarProgramIds[]

string

identyfikatory podobnych programów,
iosAppStoreId

string (int64 format)

Identyfikator w sklepie z aplikacjami na iOS. Służy do sprawdzania (przed użyciem precyzyjnego linku), czy użytkownik ma na swoim urządzeniu zainstalowaną aplikację. Jeśli to pole ma ustawioną wartość, musisz też podać „iosAppLink”.
thumbnailImageUrl

string

Adres URL miniatury, np. http://www.example.com/thumbnail.png. Obraz miniatury nie zostanie przesłany jako komponent z obrazem.
imageUrl

string

Adres URL obrazu, np. http://www.example.com/image.png. Obraz nie zostanie przesłany jako komponent z obrazem.

MobileAppAsset

Komponent reprezentujący aplikację mobilną.

Zapis JSON 
{
  "appId": string,
  "appStore": enum (MobileAppVendor),
  "linkText": string,
  "startDate": string,
  "endDate": string
}
Pola
appId

string

Wymagane. Ciąg znaków jednoznacznie identyfikujący aplikację mobilną. Powinien zawierać tylko domyślny identyfikator platformy, np. „com.android.ebay” w przypadku Androida lub „12345689” w przypadku iOS.
appStore

enum (MobileAppVendor)

Wymagane. Sklep z aplikacjami, który dystrybuuje tę konkretną aplikację.
linkText

string

Wymagane. Tekst widoczny, który jest wyświetlany, gdy link jest renderowany w reklamie. Długość tego ciągu powinna mieścić się w zakresie od 1 do 25 znaków.
startDate

string

Data rozpoczęcia obowiązywania tego zasobu i możliwości jego wyświetlania w formacie rrrr-MM-dd.
endDate

string

Ostatnia data, do której ten zasób jest aktywny i nadal wyświetlany, w formacie rrrr-MM-dd.

HotelCalloutAsset

Komponent przedstawiający objaśnienie dotyczące hotelu.

Zapis JSON 
{
  "text": string,
  "languageCode": string
}
Pola
text

string

Wymagane. Tekst komponentu z objaśnieniem dotyczącym hoteli. Długość tego ciągu powinna mieścić się w zakresie od 1 do 25 znaków.
languageCode

string

Wymagane. Język objaśnienia dotyczącego hotelu. Reprezentuje tag języka zgodny ze standardem BCP 47.

CallAsset

Komponent do wykonywania połączeń.

Zapis JSON 
{
  "countryCode": string,
  "phoneNumber": string,
  "callConversionReportingState": enum (CallConversionReportingState),
  "callConversionAction": string,
  "adScheduleTargets": [
    {
      object (AdScheduleInfo)
    }
  ]
}
Pola
countryCode

string

Wymagane. Dwuliterowy kod kraju numeru telefonu. Przykłady: „PL”, „PL”.
phoneNumber

string

Wymagane. Nieprzetworzony numer telefonu reklamodawcy. Przykłady: „1234567890”, „(123)456-7890”.
callConversionReportingState

enum (CallConversionReportingState)

Wskazuje, czy ta usługa wywołania ma używać własnego ustawienia konwersji telefonicznej, stosować ustawienie na poziomie konta czy wyłączyć konwersję telefoniczną.
callConversionAction

string

Działanie powodujące konwersję, do którego ma być przypisana konwersja z połączenia. Jeśli nie zostanie ustawione, używane jest domyślne działanie powodujące konwersję. To pole ma zastosowanie tylko wtedy, gdy ustawienie callConversionReportingState ma wartość USE_RESOURCE_LEVEL_CALL_CONVERSION_ACTION.
adScheduleTargets[]

object (AdScheduleInfo)

Lista nienakładających się harmonogramów określająca wszystkie przedziały czasu, w których zasób może się wyświetlać. W przypadku każdego dnia można utworzyć maksymalnie 6 harmonogramów, czyli łącznie 42 harmonogramy.

PriceAsset

Komponent reprezentujący listę cen ofert.

Zapis JSON 
{
  "type": enum (PriceExtensionType),
  "priceQualifier": enum (PriceExtensionPriceQualifier),
  "languageCode": string,
  "priceOfferings": [
    {
      object (PriceOffering)
    }
  ]
}
Pola
type

enum (PriceExtensionType)

Wymagane. Typ komponentu z cenami.
priceQualifier

enum (PriceExtensionPriceQualifier)

Kwalifikator ceny komponentu z cenami.
languageCode

string

Wymagane. Język komponentu z cenami. Reprezentuje tag języka zgodny ze standardem BCP 47.
priceOfferings[]

object (PriceOffering)

Ceny oferowane w komponencie z cenami. Wielkość tej kolekcji powinna mieścić się w zakresie od 3 do 8 (włącznie).

PriceExtensionType

Typ rozszerzenia cen.

Wartości w polu enum
UNSPECIFIED Nie określono.
UNKNOWN Służy tylko do zwracania wartości. Reprezentuje wartość nieznana w tej wersji.
BRANDS Typ wyświetlania listy marek.
EVENTS Typ wyświetlania listy zdarzeń.
LOCATIONS Typ pokazywania lokalizacji istotnych dla Twojej firmy.
NEIGHBORHOODS Typ pokazywania podregionów lub dzielnic w mieście lub regionie.
PRODUCT_CATEGORIES Typ służący do wyświetlania kolekcji kategorii produktów.
PRODUCT_TIERS Typ służący do wyświetlania kolekcji powiązanych poziomów produktów.
SERVICES Typ służący do wyświetlania kolekcji usług oferowanych przez Twoją firmę.
SERVICE_CATEGORIES Typ służący do wyświetlania kolekcji kategorii usług.
SERVICE_TIERS Typ służący do wyświetlania kolekcji powiązanych poziomów usług.

PriceExtensionPriceQualifier

Typy kwalifikatora ceny w rozszerzeniu cen.

Wartości w polu enum
UNSPECIFIED Nie określono.
UNKNOWN Służy tylko do zwracania wartości. Reprezentuje wartość nieznana w tej wersji.
FROM Kwalifikator „Od” dla ceny.
UP_TO Kwalifikator „do” dla ceny.
AVERAGE Kwalifikator „Średnia” dla ceny.

PriceOffering

Pojedyncza cena w ramach zasobu z cenami.

Zapis JSON 
{
  "header": string,
  "description": string,
  "price": {
    object (Money)
  },
  "unit": enum (PriceExtensionPriceUnit),
  "finalUrl": string,
  "finalMobileUrl": string
}
Pola
header

string

Wymagane. Nagłówek oferty cenowej. Długość tego ciągu powinna mieścić się w zakresie od 1 do 25 znaków.
description

string

Wymagane. Opis oferty cenowej. Długość tego ciągu powinna mieścić się w zakresie od 1 do 25 znaków.
price

object (Money)

Wymagane. Wartość ceny oferty.
unit

enum (PriceExtensionPriceUnit)

Jednostka cenowa oferty cenowej.
finalUrl

string

Wymagane. Końcowy URL po wszystkich przekierowaniach między domenami.
finalMobileUrl

string

Końcowy adres URL na urządzenie mobilne po wszystkich przekierowaniach między domenami.

PriceExtensionPriceUnit

Jednostka cenowa rozszerzenia cen.

Wartości w polu enum
UNSPECIFIED Nie określono.
UNKNOWN Służy tylko do zwracania wartości. Reprezentuje wartość nieznana w tej wersji.
PER_HOUR Za godzinę.
PER_DAY dziennie.
PER_WEEK Co tydzień.
PER_MONTH Miesięcznie.
PER_YEAR Rocznie.
PER_NIGHT Za noc.

CallToActionAsset

Komponent z wezwaniem do działania.

Zapis JSON 
{
  "callToAction": enum (CallToActionType)
}
Pola
callToAction

enum (CallToActionType)

Wezwanie do działania.

DynamicRealEstateAsset

Dynamiczny zasób dotyczący nieruchomości.

Zapis JSON 
{
  "listingId": string,
  "listingName": string,
  "cityName": string,
  "description": string,
  "address": string,
  "price": string,
  "imageUrl": string,
  "propertyType": string,
  "listingType": string,
  "contextualKeywords": [
    string
  ],
  "formattedPrice": string,
  "androidAppLink": string,
  "iosAppLink": string,
  "iosAppStoreId": string,
  "similarListingIds": [
    string
  ]
}
Pola
listingId

string

Wymagane. Identyfikator oferty, który może być dowolną sekwencją liter i cyfr. Musi być niepowtarzalny i odpowiadać wartościom tagu remarketingowego. Wymagane.
listingName

string

Wymagane. Nazwa oferty, np. Boulevard Bungalow. Wymagane.
cityName

string

Nazwa miasta, np. Mountain View w Kalifornii.
description

string

Opis, np. 3 sypialnie, 2 łazienki, 145 m2
address

string

Adres, który można podać w jednym z tych formatów. (1) Miasto, województwo, kod, kraj, np. Mountain View, CA, USA. (2) Pełny adres, np. ul. Środkowa 123, 00-018 Warszawa. (3) szerokość i długość geograficzna w formacie DDD, np. 41.40338, 2.17403
price

string

Cena, która może być liczbą z kodem waluty wyrażonym literami według normy ISO 4217. Jako znaku dziesiętnego użyj kropki, np. 200 000,00 PLN.
imageUrl

string

Adres URL obrazu, np. http://www.example.com/image.png. Obraz nie zostanie przesłany jako komponent z obrazem.
propertyType

string

Typ nieruchomości, np. dom.
listingType

string

Typ produktu, np. Na sprzedaż.
contextualKeywords[]

string

kontekstowe słowa kluczowe, np. na sprzedaż; domy na sprzedaż;
formattedPrice

string

Sformatowana cena, która może zawierać dowolne znaki. Jeśli jest ustawiony, zostanie użyty zamiast atrybutu „price”, np.Od 200 000,00 PLN.
iosAppStoreId

string (int64 format)

Identyfikator w sklepie z aplikacjami na iOS. Służy do sprawdzania (przed użyciem precyzyjnego linku), czy użytkownik ma na swoim urządzeniu zainstalowaną aplikację. Jeśli to pole ma ustawioną wartość, musisz też podać „iosAppLink”.
similarListingIds[]

string

Identyfikatory podobnych ofert.

DynamicCustomAsset

Dynamiczny komponent niestandardowy.

Zapis JSON 
{
  "id": string,
  "id2": string,
  "itemTitle": string,
  "itemSubtitle": string,
  "itemDescription": string,
  "itemAddress": string,
  "itemCategory": string,
  "price": string,
  "salePrice": string,
  "formattedPrice": string,
  "formattedSalePrice": string,
  "imageUrl": string,
  "contextualKeywords": [
    string
  ],
  "androidAppLink": string,
  "iosAppLink": string,
  "iosAppStoreId": string,
  "similarIds": [
    string
  ]
}
Pola
id

string

Wymagane. Identyfikator może być dowolną sekwencją liter i cyfr. Musi być niepowtarzalny i odpowiadać wartościom tagu remarketingowego, np. sedan. Wymagane.
id2

string

Identyfikator 2, który może być dowolną sekwencją liter i cyfr, np. czerwony. Sekwencja identyfikatorów (ID + ID2) musi być niepowtarzalna.
itemTitle

string

Wymagane. Tytuł produktu, np. Średni sedan. Wymagane.
itemSubtitle

string

Podtytuł produktu, np. U dealera w Mountain View.
itemDescription

string

Opis produktu, np. Najpopularniejszy sedan średniej wielkości.
itemAddress

string

Adres produktu, który może być podany w jednym z tych formatów. (1) Miasto, województwo, kod, kraj, np. Mountain View, CA, USA. (2) Pełny adres, np. ul. Środkowa 123, 00-018 Warszawa. (3) szerokość i długość geograficzna w formacie DDD, np. 41.40338, 2.17403
itemCategory

string

Kategoria produktu, np. sedany.
price

string

Cena, która może być liczbą z kodem waluty wyrażonym literami według normy ISO 4217. Jako znaku dziesiętnego użyj kropki, np. 20 000,00 PLN.
salePrice

string

Cena promocyjna, która może być liczbą z kodem waluty wyrażonym literami według normy ISO 4217. Jako znaku dziesiętnego użyj kropki, np. 15 000,00 PLN. Musi być mniejsza od wartości w polu „price”.
formattedPrice

string

Sformatowana cena, która może zawierać dowolne znaki. Jeśli jest ustawiony, zostanie użyty zamiast atrybutu „price”, np.Od 20 000,00 PLN.
formattedSalePrice

string

Sformatowana cena promocyjna, która może zawierać dowolne znaki. Jeśli jest ustawiony, zostanie użyty zamiast atrybutu „sale price” (cena promocyjna), np.W promocji za 15 000,00 USD.
imageUrl

string

Adres URL obrazu, np. http://www.example.com/image.png. Obraz nie zostanie przesłany jako komponent z obrazem.
contextualKeywords[]

string

kontekstowe słowa kluczowe, np. sedany, 4-drzwiowe sedany;
iosAppStoreId

string (int64 format)

Identyfikator w sklepie z aplikacjami na iOS. Służy do sprawdzania (przed użyciem precyzyjnego linku), czy użytkownik ma na swoim urządzeniu zainstalowaną aplikację. Jeśli to pole ma ustawioną wartość, musisz też podać „iosAppLink”.
similarIds[]

string

podobne identyfikatory;

DynamicHotelsAndRentalsAsset

Zasób dynamiczny związany z hotelami i wynajmem.

Zapis JSON 
{
  "propertyId": string,
  "propertyName": string,
  "imageUrl": string,
  "destinationName": string,
  "description": string,
  "price": string,
  "salePrice": string,
  "starRating": string,
  "category": string,
  "contextualKeywords": [
    string
  ],
  "address": string,
  "androidAppLink": string,
  "iosAppLink": string,
  "iosAppStoreId": string,
  "formattedPrice": string,
  "formattedSalePrice": string,
  "similarPropertyIds": [
    string
  ]
}
Pola
propertyId

string

Wymagane. Identyfikator usługi, który może być dowolną sekwencją liter i cyfr. Musi być niepowtarzalny i odpowiadać wartościom tagu remarketingowego. Wymagane.
propertyName

string

Wymagane. Nazwa usługi, np. Hotel Mountain View. Wymagane.
imageUrl

string

Adres URL obrazu, np. http://www.example.com/image.png. Obraz nie zostanie przesłany jako komponent z obrazem.
destinationName

string

nazwę miejsca docelowego, np. centrum Mountain View;
description

string

Opis, np. „W pobliżu lotniska Okęcie”.
price

string

Cena, która może być liczbą z kodem waluty wyrażonym literami według normy ISO 4217. Jako znaku dziesiętnego użyj kropki, na przykład 100.00 PLN.
salePrice

string

zgodnie ze standardem ISO 4217; Jako znak dziesiętny użyj kropki, na przykład 80.00 PLN. Musi być mniejsza od wartości w polu „price”.
starRating

string (int64 format)

Ocena w gwiazdkach. Musi być liczbą z zakresu od 1 do 5 włącznie.
category

string

Kategoria, np. apartament hotelowy.
contextualKeywords[]

string

kontekstowych słów kluczowych, np. „Hotele” Warszawa, hotele mazowsze;
address

string

Adres, który można podać w jednym z tych formatów. (1) Miasto, województwo, kod, kraj, np. Mountain View, CA, USA. (2) Pełny adres, np. ul. Środkowa 123, 00-018 Warszawa. (3) szerokość i długość geograficzna w formacie DDD, np. 41.40338, 2.17403
iosAppStoreId

string (int64 format)

Identyfikator w sklepie z aplikacjami na iOS. Służy do sprawdzania (przed użyciem precyzyjnego linku), czy użytkownik ma na swoim urządzeniu zainstalowaną aplikację. Jeśli to pole ma ustawioną wartość, musisz też podać „iosAppLink”.
formattedPrice

string

Sformatowana cena, która może zawierać dowolne znaki. Jeśli jest ustawiony, zostanie użyty zamiast atrybutu „price”, np.Od 100, 00 PLN.
formattedSalePrice

string

Sformatowana cena promocyjna, która może zawierać dowolne znaki. Jeśli jest ustawiony, zostanie użyty zamiast atrybutu „sale price” (cena promocyjna), np.W promocji za 80, 00 PLN.
similarPropertyIds[]

string

Identyfikatory podobnych usług.

DynamicFlightsAsset

Dynamiczny komponent dotyczący lotów.

Zapis JSON 
{
  "destinationId": string,
  "originId": string,
  "flightDescription": string,
  "imageUrl": string,
  "destinationName": string,
  "originName": string,
  "flightPrice": string,
  "flightSalePrice": string,
  "formattedPrice": string,
  "formattedSalePrice": string,
  "androidAppLink": string,
  "iosAppLink": string,
  "iosAppStoreId": string,
  "similarDestinationIds": [
    string
  ],
  "customMapping": string
}
Pola
destinationId

string

Wymagane. Identyfikator miejsca docelowego, który może być dowolną sekwencją liter i cyfr. Musi być niepowtarzalny i odpowiadać wartościom tagu remarketingowego. Wymagane.
originId

string

Identyfikator źródła, który może być dowolną sekwencją liter i cyfr. Sekwencja identyfikatorów (identyfikator miejsca docelowego + identyfikator miejsca wylotu) musi być niepowtarzalna.
flightDescription

string

Wymagane. Opis lotu, np. Zarezerwuj bilet. Wymagane.
imageUrl

string

Adres URL obrazu, np. http://www.example.com/image.png. Obraz nie zostanie przesłany jako komponent z obrazem.
destinationName

string

Nazwa miejsca docelowego, np. Paryż.
originName

string

Nazwa miejsca wylotu, np. Londyn.
flightPrice

string

Cena lotu, która może być liczbą z kodem waluty wyrażonym literami według normy ISO 4217. Jako znaku dziesiętnego użyj kropki, na przykład 100.00 PLN.
flightSalePrice

string

Cena promocyjna lotu, która może być liczbą z kodem waluty wyrażonym literami według normy ISO 4217. Jako znak dziesiętny użyj kropki, na przykład 80.00 PLN. Musi być mniejsza niż wartość w polu „flightPrice”.
formattedPrice

string

Sformatowana cena, która może zawierać dowolne znaki. Jeśli jest ustawiony, zostanie użyty zamiast atrybutu „price”, np.Od 100, 00 PLN.
formattedSalePrice

string

Sformatowana cena promocyjna, która może zawierać dowolne znaki. Jeśli jest ustawiony, zostanie użyty zamiast atrybutu „sale price” (cena promocyjna), np.W promocji za 80, 00 PLN.
iosAppStoreId

string (int64 format)

Identyfikator w sklepie z aplikacjami na iOS. Służy do sprawdzania (przed użyciem precyzyjnego linku), czy użytkownik ma na swoim urządzeniu zainstalowaną aplikację. Jeśli to pole ma ustawioną wartość, musisz też podać „iosAppLink”.
similarDestinationIds[]

string

Identyfikatory podobnych miejsc docelowych, np. PAR, LON.
customMapping

string

Pole niestandardowe, które może być mapowaniem wielu kluczy na wartości oddzielonych separatorami (,, | i :), w postaci „: , , ... , | : , ... , | ... | : , ... ,”, np. „wifi: most | aircraft: 320, 77W | flights: 42 | legroom: 32”.

DemandGenCarouselCardAsset

Komponent karty karuzeli generującej popyt.

Zapis JSON 
{
  "marketingImageAsset": string,
  "squareMarketingImageAsset": string,
  "portraitMarketingImageAsset": string,
  "headline": string,
  "callToActionText": string
}
Pola
marketingImageAsset

string

Nazwa zasobu komponentu powiązanego z obrazem marketingowym w proporcjach 1,91:1. Wymagany jest ten lub kwadratowy obraz marketingowy.
squareMarketingImageAsset

string

Nazwa zasobu z powiązanym kwadratowym obrazem marketingowym. Wymagany jest ten zasób lub zasób z obrazem marketingowym.
portraitMarketingImageAsset

string

Nazwa zasobu z powiązanym obrazem marketingowym w orientacji pionowej (4:5).
headline

string

Wymagane. Nagłówek karty karuzeli.
callToActionText

string

Tekst wezwania do działania.

DynamicTravelAsset

Dynamiczny zasób dotyczący podróży.

Zapis JSON 
{
  "destinationId": string,
  "originId": string,
  "title": string,
  "destinationName": string,
  "destinationAddress": string,
  "originName": string,
  "price": string,
  "salePrice": string,
  "formattedPrice": string,
  "formattedSalePrice": string,
  "category": string,
  "contextualKeywords": [
    string
  ],
  "similarDestinationIds": [
    string
  ],
  "imageUrl": string,
  "androidAppLink": string,
  "iosAppLink": string,
  "iosAppStoreId": string
}
Pola
destinationId

string

Wymagane. Identyfikator miejsca docelowego, który może być dowolną sekwencją liter i cyfr. Musi być niepowtarzalny i odpowiadać wartościom tagu remarketingowego. Wymagane.
originId

string

Identyfikator źródła, który może być dowolną sekwencją liter i cyfr. Sekwencja identyfikatorów (identyfikator miejsca docelowego + identyfikator miejsca wylotu) musi być niepowtarzalna.
title

string

Wymagane. Tytuł, np. Zarezerwuj bilet na pociąg. Wymagane.
destinationName

string

Nazwa miejsca docelowego, np. Paryż.
destinationAddress

string

Adres docelowy, który można podać w jednym z tych formatów. (1) Miasto, województwo, kod, kraj, np. Mountain View, CA, USA. (2) Pełny adres, np. ul. Środkowa 123, 00-018 Warszawa. (3) Długość i szerokość geograficzna w formie DDD, np. 41.40338, 2.17403.
originName

string

Nazwa miejsca wylotu, np. Londyn.
price

string

Cena, która może być liczbą z kodem waluty wyrażonym literami według normy ISO 4217. Jako znaku dziesiętnego użyj kropki, na przykład 100.00 PLN.
salePrice

string

Cena promocyjna, która może być liczbą z kodem waluty wyrażonym literami według normy ISO 4217. Jako znak dziesiętny użyj kropki, na przykład 80.00 PLN. Musi być mniejsza od wartości w polu „price”.
formattedPrice

string

Sformatowana cena, która może zawierać dowolne znaki. Jeśli jest ustawiony, zostanie użyty zamiast atrybutu „price”, np.Od 100, 00 PLN.
formattedSalePrice

string

Sformatowana cena promocyjna, która może zawierać dowolne znaki. Jeśli jest ustawiony, zostanie użyty zamiast atrybutu „sale price” (cena promocyjna), np.W promocji za 80, 00 PLN.
category

string

Kategoria, np. Express.
contextualKeywords[]

string

kontekstowe słowa kluczowe, np. „pociągi Paryż”;
similarDestinationIds[]

string

Identyfikatory podobnych miejsc docelowych, np. Nowy Jork.
imageUrl

string

Adres URL obrazu, np. http://www.example.com/image.png. Obraz nie zostanie przesłany jako komponent z obrazem.
iosAppStoreId

string (int64 format)

Identyfikator w sklepie z aplikacjami na iOS. Służy do sprawdzania (przed użyciem precyzyjnego linku), czy użytkownik ma na swoim urządzeniu zainstalowaną aplikację. Jeśli to pole ma ustawioną wartość, musisz też podać „iosAppLink”.

DynamicLocalAsset

Dynamiczny komponent dotyczący produktu dostępnego lokalnie.

Zapis JSON 
{
  "dealId": string,
  "dealName": string,
  "subtitle": string,
  "description": string,
  "price": string,
  "salePrice": string,
  "imageUrl": string,
  "address": string,
  "category": string,
  "contextualKeywords": [
    string
  ],
  "formattedPrice": string,
  "formattedSalePrice": string,
  "androidAppLink": string,
  "similarDealIds": [
    string
  ],
  "iosAppLink": string,
  "iosAppStoreId": string
}
Pola
dealId

string

Wymagane. Identyfikator umowy, który może być dowolną sekwencją liter i cyfr. Musi być niepowtarzalny i odpowiadać wartościom tagu remarketingowego. Wymagane.
dealName

string

Wymagane. Nazwa oferty, np. 50% zniżki na zakupy spożywcze w sklepie spożywczym w Mountain View. Wymagane.
subtitle

string

Napisy, np. „Produkty spożywcze”.
description

string

Opis, np. Oszczędzaj na cotygodniowych zakupach.
price

string

Cena, która może być liczbą z kodem waluty wyrażonym literami według normy ISO 4217. Jako znaku dziesiętnego użyj kropki, na przykład 100.00 PLN.
salePrice

string

Cena promocyjna, która może być liczbą z kodem waluty wyrażonym literami według normy ISO 4217. Jako znak dziesiętny użyj kropki, na przykład 80.00 PLN. Musi być mniejsza od wartości w polu „price”.
imageUrl

string

Adres URL obrazu, np. http://www.example.com/image.png. Obraz nie zostanie przesłany jako komponent z obrazem.
address

string

Adres, który można podać w jednym z tych formatów. (1) Miasto, województwo, kod, kraj, np. Mountain View, CA, USA. (2) Pełny adres, np. ul. Środkowa 123, 00-018 Warszawa. (3) Długość i szerokość geograficzna w formie DDD, np. 41.40338, 2.17403.
category

string

Kategoria, np. Jedzenie.
contextualKeywords[]

string

kontekstowych słów kluczowych, np. kupony oszczędnościowe na artykuły spożywcze;
formattedPrice

string

Sformatowana cena, która może zawierać dowolne znaki. Jeśli jest ustawiony, zostanie użyty zamiast atrybutu „price”, np.Od 100, 00 PLN.
formattedSalePrice

string

Sformatowana cena promocyjna, która może zawierać dowolne znaki. Jeśli jest ustawiony, zostanie użyty zamiast atrybutu „sale price” (cena promocyjna), np.W promocji za 80, 00 PLN.
similarDealIds[]

string

Identyfikatory podobnych umów, np. 1275.
iosAppStoreId

string (int64 format)

Identyfikator w sklepie z aplikacjami na iOS. Służy do sprawdzania (przed użyciem precyzyjnego linku), czy użytkownik ma na swoim urządzeniu zainstalowaną aplikację. Jeśli to pole ma ustawioną wartość, musisz też podać „iosAppLink”.

DynamicJobsAsset

Dynamiczny zasób dotyczący zadań.

Zapis JSON 
{
  "jobId": string,
  "locationId": string,
  "jobTitle": string,
  "jobSubtitle": string,
  "description": string,
  "imageUrl": string,
  "jobCategory": string,
  "contextualKeywords": [
    string
  ],
  "address": string,
  "salary": string,
  "androidAppLink": string,
  "similarJobIds": [
    string
  ],
  "iosAppLink": string,
  "iosAppStoreId": string
}
Pola
jobId

string

Wymagane. Identyfikator zadania, który może być dowolną sekwencją liter i cyfr. Musi być niepowtarzalny i odpowiadać wartościom tagu remarketingowego. Wymagane.
locationId

string

Identyfikator lokalizacji, który może być dowolną sekwencją liter i cyfr. Sekwencja identyfikatorów (identyfikator zadania + identyfikator lokalizacji) musi być niepowtarzalna.
jobTitle

string

Wymagane. stanowisko, np. inżynier oprogramowania; Wymagane.
jobSubtitle

string

Podtytuł stanowiska, np. Poziom II.
description

string

Opis, np. Praktyczne umiejętności techniczne.
imageUrl

string

Adres URL obrazu, np. http://www.example.com/image.png. Obraz nie zostanie przesłany jako komponent z obrazem.
jobCategory

string

Kategoria pracy, np. techniczna.
contextualKeywords[]

string

kontekstowe słowa kluczowe, np. „praca programisty”;
address

string

Adres, który można podać w jednym z tych formatów. (1) Miasto, województwo, kod, kraj, np. Mountain View, CA, USA. (2) Pełny adres, np. ul. Środkowa 123, 00-018 Warszawa. (3) Długość i szerokość geograficzna w formie DDD, np. 41.40338, 2.17403.
salary

string

Pensja, na przykład 100 000 USD.
similarJobIds[]

string

Identyfikatory podobnych ofert pracy, np. 1275.
iosAppStoreId

string (int64 format)

Identyfikator w sklepie z aplikacjami na iOS. Służy do sprawdzania (przed użyciem precyzyjnego linku), czy użytkownik ma na swoim urządzeniu zainstalowaną aplikację. Jeśli to pole ma ustawioną wartość, musisz też podać „iosAppLink”.

LocationAsset

Komponent z lokalizacją.

Zapis JSON 
{
  "placeId": string,
  "businessProfileLocations": [
    {
      object (BusinessProfileLocation)
    }
  ],
  "locationOwnershipType": enum (LocationOwnershipType)
}
Pola
placeId

string

Identyfikatory miejsc jednoznacznie identyfikują miejsce w bazie danych Miejsc Google i w Mapach Google. To pole jest unikalne dla danego identyfikatora klienta i typu zasobu. Więcej informacji o identyfikatorze Place ID znajdziesz na stronie https://developers.google.com/places/web-service/place-id.
businessProfileLocations[]

object (BusinessProfileLocation)

Lista lokalizacji firm klienta. Zwracana jest tylko wtedy, gdy komponent z lokalizacją jest synchronizowany z konta profilu firmy. Na jednym koncie może być wiele wizytówek firm, które wskazują ten sam identyfikator miejsca.
locationOwnershipType

enum (LocationOwnershipType)

Typ własności lokalizacji. Jeśli typ to BUSINESS_OWNER, zostanie on wyświetlany jako rozszerzenie lokalizacji. Jeśli typ to AFFILIATE, reklama będzie wyświetlana jako lokalizacja powiązana.

BusinessProfileLocation

dane o lokalizacji profilu firmy zsynchronizowane z połączonego konta w usłudze Profil Firmy,

Zapis JSON 
{
  "labels": [
    string
  ],
  "storeCode": string,
  "listingId": string
}
Pola
labels[]

string

Etykieta podana przez reklamodawcę dla lokalizacji na koncie Profilu Firmy. Ta informacja jest synchronizowana z konta Profilu Firmy.
storeCode

string

Kod sklepu z profilu firmy tej lokalizacji. Ta informacja jest synchronizowana z konta Profilu Firmy.
listingId

string (int64 format)

Identyfikator strony z ofertą w profilu firmy. Ta informacja jest synchronizowana z połączonego konta w usłudze Profil Firmy.

HotelPropertyAsset

Zasób obiektu hotelowego.

Zapis JSON 
{
  "placeId": string,
  "hotelAddress": string,
  "hotelName": string
}
Pola
placeId

string

Identyfikatory miejsc jednoznacznie identyfikują miejsce w bazie danych Miejsc Google i w Mapach Google. Więcej informacji znajdziesz na stronie https://developers.google.com/places/web-service/place-id.
hotelAddress

string

Adres hotelu. Tylko do odczytu.
hotelName

string

Nazwa hotelu. Tylko do odczytu.

BusinessMessageAsset

Komponent do wysyłania wiadomości do firmy.

Zapis JSON 
{
  "messageProvider": enum (BusinessMessageProvider),
  "starterMessage": string,
  "callToAction": {
    object (BusinessMessageCallToActionInfo)
  },

  // Union field message_provider_data can be only one of the following:
  "whatsappInfo": {
    object (WhatsappBusinessMessageInfo)
  }
  // End of list of possible types for union field message_provider_data.
}
Pola
messageProvider

enum (BusinessMessageProvider)

Wymagane. Dostawca wiadomości komponentu do wysyłania wiadomości do firmy.
starterMessage

string

Wymagane. wiadomość powitalną, która zachęca użytkownika do rozpoczęcia rozmowy;
callToAction

object (BusinessMessageCallToActionInfo)

Wezwanie do działania w komponencie z wiadomością biznesową.
Pole unii message_provider_data. Informacje o dostawcy wiadomości, które mają być używane do wysyłania wiadomości. message_provider_data może być tylko jednym z tych elementów:
whatsappInfo

object (WhatsappBusinessMessageInfo)

WhatsApp.

BusinessMessageProvider

Możliwa wartość typu dostawcy wiadomości biznesowych.

Wartości w polu enum
UNSPECIFIED Nie określono.
UNKNOWN Służy tylko do zwracania wartości. Reprezentuje wartość nieznana w tej wersji.
WHATSAPP Dostawca wiadomości WhatsApp

BusinessMessageCallToActionInfo

wyświetlać informacje zachęcające użytkownika do podjęcia działania;

Zapis JSON 
{
  "callToActionSelection": enum (BusinessMessageCallToActionType),
  "callToActionDescription": string
}
Pola
callToActionSelection

enum (BusinessMessageCallToActionType)

Wymagane. Wstępnie zdefiniowany tekst wezwania do działania.
callToActionDescription

string

Wymagane. Tekst przedstawiający jasną propozycję wartości, która określa, czego użytkownicy mogą się spodziewać po wykonaniu danego działania. Przykłady: „Wyślij nam wiadomość, aby uzyskać wycenę”, „Zadaj pytanie naszemu zespołowi ekspertów”.

BusinessMessageCallToActionType

Wyliczenie opisujące typy wezwań do działania w wiadomościach biznesowych.

Wartości w polu enum
UNSPECIFIED Nie określono.
UNKNOWN Służy tylko do zwracania wartości. Reprezentuje wartość nieznana w tej wersji.
APPLY_NOW Zgłoś się teraz.
BOOK_NOW Zarezerwuj teraz.
CONTACT_US Skontaktuj się z nami.
GET_INFO Uzyskaj informacje.
GET_OFFER Skorzystaj z oferty.
GET_QUOTE Uzyskaj wycenę.
GET_STARTED Zaczynamy
LEARN_MORE Więcej informacji

WhatsappBusinessMessageInfo

informacje z WhatsAppa, które będą używane do wysyłania wiadomości;

Zapis JSON 
{
  "countryCode": string,
  "phoneNumber": string
}
Pola
countryCode

string

Wymagane. Dwuliterowy kod kraju numeru telefonu. Przykłady: „PL”, „PL”.
phoneNumber

string

Wymagane. Numer telefonu firmy w WhatsApp. Przykłady: „1234567890”, „(123)456-7890”.

AppDeepLinkAsset

Zasób precyzyjnego linku do aplikacji

Zapis JSON 
{
  "appDeepLinkUri": string
}
Pola