Asset

Zasób to część reklamy, która może być współużytkowana przez wiele reklam. Może to być obraz (ImageAsset), film (YouTubeVideoAsset) itp. Komponentów nie można zmienić i nie można ich usunąć. Aby zatrzymać wyświetlanie komponentu, usuń go z elementu, który z niego korzysta.

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)
  },
  "discoveryCarouselCardAsset": {
    object (DiscoveryCarouselCardAsset)
  },
  "dynamicTravelAsset": {
    object (DynamicTravelAsset)
  },
  "dynamicLocalAsset": {
    object (DynamicLocalAsset)
  },
  "dynamicJobsAsset": {
    object (DynamicJobsAsset)
  },
  "locationAsset": {
    object (LocationAsset)
  },
  "hotelPropertyAsset": {
    object (HotelPropertyAsset)
  }
  // End of list of possible types for union field asset_data.
}
Pola
resourceName

string

Stałe. Nazwa zasobu. Nazwy zasobów zasobów mają postać:

customers/{customerId}/assets/{asset_id}

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 mobilnych adresów URL po wszystkich przekierowaniach między domenami.

urlCustomParameters[]

object (CustomParameter)

Lista mapowań, które mają być używane do zastępowania tagów niestandardowych parametrów adresu URL w parametrach TrackingUrlTemplate, finalUrls lub finalMobileUrls.

source

enum (AssetSource)

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

policySummary

object (AssetPolicySummary)

Tylko dane wyjściowe. Informacje o zasadzie dotyczącej zasobu.

fieldTypePolicySummaries[]

object (AssetFieldTypePolicySummary)

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

id

string (int64 format)

Tylko dane wyjściowe. Identyfikator zasobu.

name

string

Opcjonalna nazwa zasobu.

trackingUrlTemplate

string

Szablon URL do tworzenia linku monitorującego.

finalUrlSuffix

string

Szablon URL służący do dołączania parametrów do adresów URL stron docelowych udostępnianych ze śledzeniem równoległym.

Pole sumy asset_data. Konkretny typ zasobu. asset_data może być tylko jedną z tych wartości:
youtubeVideoAsset

object (YoutubeVideoAsset)

Stałe. Komponent wideo w YouTube.

mediaBundleAsset

object (MediaBundleAsset)

Stałe. Zasób pakietu kreacji multimedialnych.

imageAsset

object (ImageAsset)

Tylko dane wyjściowe. Komponent z obrazem.

textAsset

object (TextAsset)

Stałe. Komponent tekstowy.

leadFormAsset

object (LeadFormAsset)

Komponent z formularzem kontaktowym.

bookOnGoogleAsset

object (BookOnGoogleAsset)

Zasób książki w Google.

promotionAsset

object (PromotionAsset)

Komponent z promocją.

calloutAsset

object (CalloutAsset)

komponent z objaśnieniem,

structuredSnippetAsset

object (StructuredSnippetAsset)

Komponent z rozszerzeniem informacji.

pageFeedAsset

object (PageFeedAsset)

Komponent z adresem stron docelowych.

dynamicEducationAsset

object (DynamicEducationAsset)

Dynamiczny zasób edukacyjny.

mobileAppAsset

object (MobileAppAsset)

Komponent z linkiem do 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)

Stałe. Komponent z wezwaniem do działania.

dynamicRealEstateAsset

object (DynamicRealEstateAsset)

Dynamiczny zasób nieruchomości.

dynamicCustomAsset

object (DynamicCustomAsset)

Dynamiczny zasób niestandardowy.

dynamicHotelsAndRentalsAsset

object (DynamicHotelsAndRentalsAsset)

Dynamiczny zasób dotyczący hoteli i wynajmu.

dynamicFlightsAsset

object (DynamicFlightsAsset)

Zasób dynamiczny „Loty”.

dynamicTravelAsset

object (DynamicTravelAsset)

Dynamiczny zasób związany z podróżami.

dynamicLocalAsset

object (DynamicLocalAsset)

Dynamiczny zasób lokalny.

dynamicJobsAsset

object (DynamicJobsAsset)

Dynamiczny zasób ofert pracy.

locationAsset

object (LocationAsset)

Tylko dane wyjściowe. Komponent z lokalizacją.

hotelPropertyAsset

object (HotelPropertyAsset)

Stałe. Komponent typu hotel.

AssetType

Wartość Enum opisująca możliwe typy zasobu.

Wartości w polu enum
UNSPECIFIED Nie określono.
UNKNOWN Używana tylko w przypadku wartości zwracanej. Reprezentuje wartość nieznaną 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 Komponent Zarezerwuj z Google.
PROMOTION Komponent z promocją.
CALLOUT Komponent z objaśnieniem.
STRUCTURED_SNIPPET Komponent z rozszerzeniem informacji.
PAGE_FEED Komponent z plikiem z adresami stron docelowych.
DYNAMIC_EDUCATION Dynamiczny zasób edukacyjny.
MOBILE_APP Komponent z linkiem do 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 zasób związany z nieruchomościami.
DYNAMIC_CUSTOM Dynamiczny zasób niestandardowy.
DYNAMIC_HOTELS_AND_RENTALS Dynamiczny zasób dotyczący hoteli i wynajmu.
DYNAMIC_FLIGHTS Zasób dynamicznych lotów.
DYNAMIC_TRAVEL Dynamiczny komponent związany z podróżami.
DYNAMIC_LOCAL Dynamiczny zasób lokalny.
DYNAMIC_JOBS Dynamiczny zasób z ofertami pracy.
LOCATION Komponent z lokalizacją.
HOTEL_PROPERTY Komponent dotyczący obiektu hotelowego.

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 dotyczących zasad dla tego zasobu.

reviewStatus

enum (PolicyReviewStatus)

Tylko dane wyjściowe. Gdzie w procesie weryfikacji znajduje się ten komponent.

approvalStatus

enum (PolicyApprovalStatus)

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

AssetFieldTypePolicySummary

Zawiera informacje o zasadach dotyczących zasobu w kontekście AssetFieldType.

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

enum (AssetFieldType)

Tylko dane wyjściowe. FieldType tego zasobu.

assetSource

enum (AssetSource)

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

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. Jest to ciąg 11 znaków używany w adresie URL filmu w YouTube.

MediaBundleAsset

Zasób MediaBundle.

Zapis JSON
{
  "data": string
}
Pola
data

string (bytes format)

Dane zasobu pakietu kreacji multimedialnych (plik ZIP). Format przesłanego pliku ZIP zależy od pola reklamy, w którym zostanie on użyty. Więcej informacji o tym formacie znajdziesz w dokumentacji pola reklamy, w którym planujesz używać zasobu MediaBundleAsset. To pole zawiera tylko mutacje.

Ciąg zakodowany w standardzie base64.

ImageAsset

Komponent z obrazem.

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

enum (MimeType)

Typ MIME zasobu graficznego.

fullSize

object (ImageDimension)

Metadane tego obrazu w oryginalnym rozmiarze.

data

string (bytes format)

Nieprzetworzone bajty obrazu. To pole zawiera tylko mutacje.

Ciąg zakodowany w standardzie base64.

fileSize

string (int64 format)

Rozmiar pliku komponentu z obrazem w bajtach.

ImageDimension

Metadane obrazu w określonym rozmiarze (oryginalne lub zmienione).

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, który zwraca obraz o tej wysokości i szerokości.

TextAsset

Komponent tekstowy.

Zapis JSON
{
  "text": string
}
Pola
text

string

Treść 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

To pole jest wymagane. Nazwa reklamowanej firmy.

callToActionType

enum (LeadFormCallToActionType)

To pole jest wymagane. Wstępnie zdefiniowany wyświetlany tekst, który zachęca użytkownika do rozwinięcia formularza.

callToActionDescription

string

To pole jest wymagane. Tekst zawierający jasną propozycję wartości, której użytkownicy oczekują po rozwinięciu formularza.

headline

string

To pole jest wymagane. Nagłówek rozwiniętego formularza, który opisuje, czego dotyczy formularz lub go ułatwia.

description

string

To pole jest wymagane. Szczegółowy opis rozwiniętego formularza, który zawiera informacje o tym, czego on dotyczy lub jakie ułatwia zadanie.

privacyPolicyUrl

string

To pole jest wymagane. Link do strony z opisem zasad obsługi zebranych danych przez reklamodawcę lub firmę.

fields[]

object (LeadFormField)

Uporządkowana lista pól do wprowadzania danych. To pole można zaktualizować, zmieniając kolejność pytań, ale nie dodając lub usuwając pytania.

customQuestionFields[]

object (LeadFormCustomQuestionField)

Uporządkowana lista pól niestandardowych pytań. W tym polu dostępnych jest maksymalnie 5 pytań kwalifikujących się na formularz.

deliveryMethods[]

object (LeadFormDeliveryMethod)

Skonfigurowane metody gromadzenia danych o potencjalnych klientach, które mają zostać dostarczone reklamodawcy. Można skonfigurować tylko jedną metodę określoną jako WebhookDelivery.

postSubmitCallToActionType

enum (LeadFormPostSubmitCallToActionType)

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

desiredIntent

enum (LeadFormDesiredIntent)

zamiary związane z formularzem kontaktowym, np. zwiększenie liczby konwersji lub większej liczby zainteresowanych użytkowników;

postSubmitHeadline

string

Nagłówek tekstu wyświetlanego po przesłaniu formularza, który opisuje, co reklamodawca ma zrobić z użytkownikiem.

postSubmitDescription

string

Po przesłaniu formularza dostępny jest szczegółowy opis, w którym reklamodawca określa dalsze działania z użytkownikiem.

backgroundImageAsset

string

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

customDisclosure

string

Niestandardowe oświadczenia wyświetlane wraz z wyłączeniem odpowiedzialności od Google w formularzu kontaktowym. Dostępne tylko dla zaakceptowanych klientów.

LeadFormCallToActionType

Enum opisujący typ wezwań do działania w formularzu kontaktowym.

Wartości w polu enum
UNSPECIFIED Nie określono.
UNKNOWN Używana tylko w przypadku wartości zwracanej. Reprezentuje wartość nieznaną w tej wersji.
LEARN_MORE Dowiedz się więcej
GET_QUOTE Sprawdź cenę.
APPLY_NOW Zgłoś się już 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

1 wystąpienie pola do wprowadzania danych w formularzu.

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ć wstępnie zdefiniowanym typem pojazdu, np. „imię i nazwisko”, lub wstępnie sprawdzonym pytaniem, np. „Jaki masz pojazd?”.

Pole sumy answers. Określa konfigurację odpowiedzi akceptowanej w tym polu formularza. Jeśli wartość 1 z tych wartości nie jest określona, jest to odpowiedź dowolna. answers może być tylko jedną z tych wartości:
singleChoiceAnswers

object (LeadFormSingleChoiceAnswers)

Konfiguracja odpowiedzi na pytanie jednokrotnego wyboru. To ustawienie można ustawić tylko dla wcześniej sprawdzonych pól pytań. Wymagane są co najmniej 2 odpowiedzi, a maksymalnie 12.

hasLocationAnswer

boolean

Konfiguracja odpowiedzi na pytanie dotyczące lokalizacji. Jeśli wybrano opcję true, dane o lokalizacji na poziomie kampanii lub konta (województwo, miasto, nazwa firmy itp.) będą renderowane w formularzu kontaktowym. Od wersji 13.1 parametr hasLocationAnswer można ustawić tylko w odpowiedzi na pytanie „Jaki jest Twój preferowany salon samochodowy?” w przypadku reklamodawców, którzy mają komponenty z lokalizacją skonfigurowane na poziomie kampanii lub konta.

LeadFormSingleChoiceAnswers

Określa możliwe odpowiedzi na pytanie jednokrotnego wyboru, zwykle w formie listy jednokrotnego wyboru.

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

string

Lista opcji w polu pojedynczego pytania. Kolejność wpisów określa kolejność w interfejsie użytkownika. Wymagane są co najmniej 2 odpowiedzi, a maksymalnie 12.

LeadFormCustomQuestionField

Wystąpienie 1 wystąpienia pola do wprowadzania niestandardowego pytania 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 sumy answers. Określa konfigurację odpowiedzi akceptowanej w tym polu formularza. Jeśli wartość 1 z tych wartości nie jest określona, jest to odpowiedź dowolna. answers może być tylko jedną z tych wartości:
singleChoiceAnswers

object (LeadFormSingleChoiceAnswers)

Konfiguracja odpowiedzi na pytanie jednokrotnego wyboru. Dozwolone są minimum 2 odpowiedzi, a maksymalnie 12.

hasLocationAnswer

boolean

Konfiguracja odpowiedzi na pytanie dotyczące lokalizacji. Jeśli wybrano opcję true, dane o lokalizacji na poziomie kampanii lub konta (województwo, miasto, nazwa firmy itp.) będą renderowane w formularzu kontaktowym. Od wersji 13.1 parametr hasLocationAnswer można ustawić tylko w odpowiedzi na pytanie „Jaki jest Twój preferowany salon samochodowy?” w przypadku reklamodawców, którzy mają komponenty z lokalizacją skonfigurowane na poziomie kampanii lub konta.

LeadFormDeliveryMethod

Konfiguracja sposobu dostarczania reklamodawcy kontaktów do potencjalnych klientów.

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 sumy delivery_details. Różne podtypy dostawy. delivery_details może być tylko jedną z tych wartości:
webhook

object (WebhookDelivery)

Metoda dostarczania webhooka.

WebhookDelivery

Google powiadamia reklamodawcę o potencjalnych klientach, wysyłając wywołania HTTP do określonego przez niego punktu końcowego. Żądania zawierają kod JSON zgodny ze schematem publikowanym przez Google w ramach dokumentacji dotyczącej reklam z formularzem.

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

string

Adres URL webhooka określony przez reklamodawcę w celu wysłania potencjalnego klienta.

googleSecret

string

Obiekt tajny zapobiegający podszywaniu się ustawiony przez reklamodawcę w ramach ładunku webhooka.

payloadSchemaVersion

string (int64 format)

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

LeadFormPostSubmitCallToActionType

Enum opisujący typ wezwań do działania po przesłaniu w przypadku formularza kontaktowego.

Wartości w polu enum
UNSPECIFIED Nie określono.
UNKNOWN Używana tylko w przypadku wartości zwracanej. Reprezentuje wartość nieznaną w tej wersji.
VISIT_SITE Otwórz witrynę.
DOWNLOAD Pobierz.
LEARN_MORE Dowiedz się więcej
SHOP_NOW Kup teraz.

LeadFormDesiredIntent

Wartość Enum opisująca wybrany poziom zamiaru pozyskania potencjalnych klientów.

Wartości w polu enum
UNSPECIFIED Nie określono.
UNKNOWN Używana tylko w przypadku wartości zwracanej. Reprezentuje wartość nieznaną w tej wersji.
LOW_INTENT Zdobywanie większej liczby potencjalnych klientów przy potencjalnie niższej jakości.
HIGH_INTENT Dostarczaj bardziej wartościowych potencjalnych klientów.

BookOnGoogleAsset

Ten typ nie ma żadnych pól.

Zasób książki z Google. Służy do przekierowywania użytkownika do rezerwacji w Google. Usługa Zarezerwuj z Google zmieni przekierowanie, aby dokonać rezerwacji 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

To pole jest wymagane. Swobodny opis przedmiotu promocji.

discountModifier

enum (PromotionExtensionDiscountModifier)

Modyfikator kwalifikacji rabatu.

redemptionStartDate

string

Data rozpoczęcia okresu, w którym można skorzystać z promocji, podana w formacie rrrr-MM-dd.

redemptionEndDate

string

Ostatnia data, w której można skorzystać z promocji, podana w formacie rrrr-MM-dd.

occasion

enum (PromotionExtensionOccasion)

Okazja, dla której była przeznaczona promocja. Jeśli masz ustawioną okazję, okres ważności musi mieścić się w powiązanym z nią zakresie dat.

languageCode

string

Język promocji. Reprezentowane jako tag języka BCP 47.

startDate

string

Data rozpoczęcia wyświetlania zasobu w formacie rrrr-MM-dd.

endDate

string

Data ostatniej daty ważności tego komponentu i nadal jest wyświetlana. Czas jest w formacie rrrr-MM-dd.

adScheduleTargets[]

object (AdScheduleInfo)

Lista nienakładających się harmonogramów określająca wszystkie przedziały czasowe, w których zasób może się wyświetlać. Można ustawić maksymalnie 6 harmonogramów na dzień, a łącznie 42.

Pole sumy discount_type. Typ rabatu może przyjmować wartość procentową lub kwotową. discount_type może mieć tylko jedną z tych wartości:
percentOff

string (int64 format)

Rabat procentowy w promocji. 1 000 000 = 100%. Wymagana jest ta wartość lub parametrMoneyAmountOff.

moneyAmountOff

object (Money)

Rabat kwotowy na rabat w ramach promocji. Wymagana jest ta wartość lub percentOff.

Pole sumy promotion_trigger. Reguła promocji. Można użyć kodu promocyjnego lub promocji z uwzględnieniem kwalifikującej się kwoty zamówienia. promotion_trigger może być tylko jedną z tych wartości:
promotionCode

string

Kod, który musi użyć użytkownik, aby kwalifikować się do promocji.

ordersOverAmount

object (Money)

Kwota łączna zamówienia musi być wymagana, aby użytkownik kwalifikował się do skorzystania z promocji.

CalloutAsset

komponent z objaśnieniem,

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

string

To pole jest wymagane. Tekst objaśnienia. Jego długość powinna mieścić się w przedziale od 1 do 25 włącznie.

startDate

string

Data rozpoczęcia wyświetlania zasobu w formacie rrrr-MM-dd.

endDate

string

Data ostatniej daty ważności tego komponentu i nadal jest wyświetlana. Czas jest w formacie rrrr-MM-dd.

adScheduleTargets[]

object (AdScheduleInfo)

Lista nienakładających się harmonogramów określająca wszystkie przedziały czasowe, w których zasób może się wyświetlać. Można ustawić maksymalnie 6 harmonogramów na dzień, a łącznie 42.

StructuredSnippetAsset

Komponent z rozszerzeniem informacji

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

string

To pole jest wymagane. Nagłówek krótkiego opisu. Powinien to być jedna z wartości wstępnie zdefiniowanych na stronie https://developers.google.com/google-ads/api/reference/data/structured-snippet-headers.

values[]

string

To pole jest wymagane. Wartości we fragmencie. Rozmiar tej kolekcji powinien wynosić od 3 do 10 włącznie. Każda wartość powinna zawierać od 1 do 25 znaków.

SitelinkAsset

Komponent z linkami do podstron.

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

string

Pierwszy wiersz opisu linku do podstrony. Jeśli jest ustawiony, długość powinna mieścić się w przedziale od 1 do 35 włącznie i należy też ustawić opis2.

description2

string

Drugi wiersz opisu linku do podstrony. Jeśli jest ustawiony, długość powinna mieścić się w przedziale od 1 do 35 włącznie i należy też ustawić opis1.

startDate

string

Data rozpoczęcia wyświetlania zasobu w formacie rrrr-MM-dd.

endDate

string

Data ostatniej daty ważności tego komponentu i nadal jest wyświetlana. Czas jest w formacie rrrr-MM-dd.

adScheduleTargets[]

object (AdScheduleInfo)

Lista nienakładających się harmonogramów określająca wszystkie przedziały czasowe, w których zasób może się wyświetlać. Można ustawić maksymalnie 6 harmonogramów na dzień, a łącznie 42.

PageFeedAsset

Komponent z adresami stron docelowych.

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

string

To pole jest wymagane. Strona internetowa, na którą chcą kierować reklamy reklamodawcy.

labels[]

string

Etykiety używane do grupowania adresów URL stron.

DynamicEducationAsset

Dynamiczny zasób 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

To pole jest wymagane. Identyfikator programu, który może być dowolną sekwencją liter i cyfr oraz musi być niepowtarzalny i pasować do wartości tagu remarketingowego. To pole jest wymagane.

locationId

string

Identyfikator lokalizacji, który może być dowolną sekwencją liter oraz cyfr i nie może się powtarzać.

programName

string

To pole jest wymagane. Nazwa programu, na przykład Opieka. To pole jest wymagane.

subject

string

Temat badania, na przykład Zdrowie.

programDescription

string

Opis programu, na przykład certyfikacja pielęgniarska.

schoolName

string

Nazwa szkoły, na przykład Szkoła pielęgniarstwa w Warszawie.

address

string

Adres szkoły, który można podać w jednym z poniższych formatów. (1) Miasto, stan, kod, kraj, np. Mountain View, CA, USA. (2) Pełny adres, na przykład ul. Główna 123, Warszawa, Polska. (3) szerokość i długość geograficzna w formacie DDD, na przykład 41.40338, 2.17403

contextualKeywords[]

string

Kontekstowe słowa kluczowe, 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 jest ustawione, musi też być obecne pole iosAppLink.

thumbnailImageUrl

string

Adres URL miniatury obrazu, 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

To pole jest wymagane. Ciąg znaków, który jednoznacznie identyfikuje aplikację mobilną. Powinien on zawierać tylko identyfikator natywny platformy, np. „com.android.ebay” w przypadku Androida lub „12345689” w przypadku iOS.

appStore

enum (MobileAppVendor)

To pole jest wymagane. Sklep z aplikacjami, który dystrybuuje tę konkretną aplikację.

startDate

string

Data rozpoczęcia wyświetlania zasobu w formacie rrrr-MM-dd.

endDate

string

Data ostatniej daty ważności tego komponentu i nadal jest wyświetlana. Czas jest w formacie rrrr-MM-dd.

HotelCalloutAsset

Komponent reprezentujący objaśnienie dotyczące hoteli.

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

string

To pole jest wymagane. Tekst komponentu z objaśnieniem dotyczącym hoteli. Jego długość powinna mieścić się w przedziale od 1 do 25 włącznie.

languageCode

string

To pole jest wymagane. Język objaśnienia dotyczącego hotelu. Reprezentowane jako tag języka 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

To pole jest wymagane. Dwuliterowy kod kraju z numerem telefonu. Przykłady: „PL”, „pl”.

phoneNumber

string

To pole jest wymagane. Nieprzetworzony numer telefonu reklamodawcy. Przykłady: „1234567890”, „(123)456-7890”.

callConversionReportingState

enum (CallConversionReportingState)

Wskazuje, czy ten komponent do wykonywania połączeń powinien używać własnego ustawienia konwersji telefonicznych, przestrzegać ustawień na poziomie konta, czy wyłączyć konwersje telefoniczne.

callConversionAction

string

Działanie powodujące konwersję, do którego przypisać konwersję telefoniczną. Jeśli zasada nie jest skonfigurowana, używane jest domyślne działanie powodujące konwersję. To pole ma zastosowanie tylko wtedy, gdy parametr 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 czasowe, w których zasób może się wyświetlać. Można ustawić maksymalnie 6 harmonogramów na dzień, a łącznie 42.

PriceAsset

Komponent reprezentujący listę ofert cenowych.

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

enum (PriceExtensionType)

To pole jest wymagane. Typ komponentu z cenami.

priceQualifier

enum (PriceExtensionPriceQualifier)

Kwalifikator ceny komponentu z cenami.

languageCode

string

To pole jest wymagane. Język komponentu z cenami. Reprezentowane jako tag języka BCP 47.

priceOfferings[]

object (PriceOffering)

Oferta cenowa komponentu z cenami. Rozmiar tej kolekcji powinien mieścić się w przedziale od 3 do 8 włącznie.

PriceOffering

Jedna oferta cenowa w komponencie cenowym.

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

string

To pole jest wymagane. Nagłówek oferty ceny. Jego długość powinna mieścić się w przedziale od 1 do 25 włącznie.

description

string

To pole jest wymagane. Opis oferowanej ceny. Jego długość powinna mieścić się w przedziale od 1 do 25 włącznie.

price

object (Money)

To pole jest wymagane. Wartość ceny oferowanej.

unit

enum (PriceExtensionPriceUnit)

Jednostka ceny oferty.

finalUrl

string

To pole jest wymagane. Końcowy adres URL po wszystkich przekierowaniach między domenami.

finalMobileUrl

string

Końcowy mobilny adres URL po wszystkich przekierowaniach między domenami.

CallToActionAsset

Komponent z wezwaniem do działania.

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

enum (CallToActionType)

Wezwanie do działania.

DynamicRealEstateAsset

Dynamiczny zasób 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

To pole jest wymagane. Identyfikator wpisu, który może być dowolną sekwencją liter i cyfr oraz musi być niepowtarzalny i pasować do wartości tagu remarketingowego. To pole jest wymagane.

listingName

string

To pole jest wymagane. Nazwa oferty, na przykład Bungalowy przy bulwarze. To pole jest wymagane.

cityName

string

Nazwa miasta, na przykład Warszawa, mazowieckie.

description

string

Opis, na przykład 3 sypialnie, 2 łazienki, 125 m2

address

string

Adres, który można podać w jednym z poniższych formatów. (1) Miasto, stan, kod, kraj, np. Mountain View, CA, USA. (2) Pełny adres, na przykład ul. Główna 123, Warszawa, Polska. (3) szerokość i długość geograficzna w formacie DDD, na przykład 41.40338, 2.17403

price

string

Cena, która może być liczbą, po której następuje kod waluty w kolejności alfabetycznej, według normy ISO 4217. Używaj kropki jako znaku dziesiętnego, 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, na przykład Dom.

listingType

string

Rodzaj informacji o produkcie, na przykład 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, będzie używany zamiast atrybutu „price” [cena], 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 jest ustawione, musi też być obecne pole iosAppLink.

similarListingIds[]

string

Identyfikatory podobnych produktów.

DynamicCustomAsset

Dynamiczny zasób 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

To pole jest wymagane. Identyfikator, który może być dowolną sekwencją liter i cyfr, musi być niepowtarzalny i pasować do wartości tagu remarketingowego, np. sedan. To pole jest wymagane.

id2

string

Identyfikator2, który może być dowolnym ciągiem liter i cyfr, np. czerwony. Sekwencja identyfikatorów (ID + ID2) musi być niepowtarzalna.

itemTitle

string

To pole jest wymagane. Tytuł produktu, na przykład średni sedan. To pole jest wymagane.

itemSubtitle

string

Podtytuł produktu, np. W Twoim salonie samochodowym w Mountain View.

itemDescription

string

Opis produktu, np. najlepiej sprzedający się samochód średniej wielkości.

itemAddress

string

Adres produktu, który można określić w jednym z poniższych formatów. (1) Miasto, stan, kod, kraj, np. Mountain View, CA, USA. (2) Pełny adres, na przykład ul. Główna 123, Warszawa, Polska. (3) szerokość i długość geograficzna w formacie DDD, na przykład 41.40338, 2.17403

itemCategory

string

Kategoria produktu, na przykład sedany.

price

string

Cena, która może być liczbą, po której następuje kod waluty w kolejności alfabetycznej, według normy ISO 4217. Używaj kropki jako znaku dziesiętnego, np. 20,000.00 PLN.

salePrice

string

Cena promocyjna, która może być liczbą, po której następuje kod waluty w kolejności alfabetycznej, według normy ISO 4217. Używaj kropki jako znaku dziesiętnego, np. 15 000.00 PLN. Wartość musi być mniejsza niż wartość w polu „cena”.

formattedPrice

string

Sformatowana cena, która może zawierać dowolne znaki. Jeśli jest ustawiony, będzie używany zamiast atrybutu „cena” [price], np. „Od 20 000,00 PLN”.

formattedSalePrice

string

Sformatowana cena promocyjna, która może zawierać dowolne znaki. Jeśli jest ustawiony, będzie używany zamiast atrybutu „cena promocyjna”, np. „Wyprzedaż za 15 000,00 PLN”.

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 jest ustawione, musi też być obecne pole iosAppLink.

similarIds[]

string

Podobne identyfikatory.

DynamicHotelsAndRentalsAsset

Dynamiczny zasób dotyczący hoteli i wynajmu.

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

To pole jest wymagane. Identyfikator usługi, który może być dowolną sekwencją liter i cyfr oraz musi być niepowtarzalny i pasować do wartości tagu remarketingowego. To pole jest wymagane.

propertyName

string

To pole jest wymagane. Nazwa obiektu, na przykład Hotel Mountain View. To pole jest 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. Centrum Warszawa.

description

string

Opis, na przykład w pobliżu lotniska SJC.

price

string

Cena, która może być liczbą, po której następuje kod waluty w kolejności alfabetycznej, według normy ISO 4217. Użyj kropki jako znaku dziesiętnego, np. 100.00 PLN.

salePrice

string

ISO 4217 Użyj kropki jako znaku dziesiętnego, np. 80.00 PLN. Wartość musi być mniejsza niż wartość w polu „cena”.

starRating

string (int64 format)

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

category

string

Kategoria, na przykład Apartament hotelowy.

contextualKeywords[]

string

Kontekstowe słowa kluczowe, np. „Hotele Warszawa”, hotele mazowieckie.

address

string

Adres, który można podać w jednym z poniższych formatów. (1) Miasto, stan, kod, kraj, np. Mountain View, CA, USA. (2) Pełny adres, na przykład ul. Główna 123, Warszawa, Polska. (3) szerokość i długość geograficzna w formacie DDD, na przykład 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 jest ustawione, musi też być obecne pole iosAppLink.

formattedPrice

string

Sformatowana cena, która może zawierać dowolne znaki. Jeśli jest ustawiony, będzie używany zamiast atrybutu „cena” [price], np. „Od 100, 00 PLN”.

formattedSalePrice

string

Sformatowana cena promocyjna, która może zawierać dowolne znaki. Jeśli jest ustawiony, będzie używany zamiast atrybutu „cena promocyjna”, np. „Wyprzedaż za 80, 00 PLN”.

similarPropertyIds[]

string

Identyfikatory podobnych usług.

DynamicFlightsAsset

Zasób dynamiczny „Loty”.

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

To pole jest wymagane. Identyfikator miejsca docelowego, który może być dowolną sekwencją liter i cyfr oraz musi być niepowtarzalny i pasować do wartości tagu remarketingowego. To pole jest wymagane.

originId

string

Identyfikator punktu początkowego, który może być dowolnym ciągiem liter i cyfr. Sekwencja identyfikatorów (identyfikator miejsca docelowego + identyfikator punktu początkowego) musi być niepowtarzalna.

flightDescription

string

To pole jest wymagane. opis lotu, np. „Zarezerwuj bilet”. To pole jest 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, na przykład Paryż.

originName

string

Nazwa punktu początkowego, np. Londyn.

flightPrice

string

Cena lotu, która może być liczbą, po której następuje kod waluty w kolejności alfabetycznej, zgodnie ze standardem ISO 4217. Użyj kropki jako znaku dziesiętnego, np. 100.00 PLN.

flightSalePrice

string

Cena promocyjna lotu, po której następuje liczba z kodem waluty wyrażonym literami według normy ISO 4217. Użyj kropki jako znaku dziesiętnego, np. 80.00 PLN. Wartość musi być mniejsza niż wartość w polu „flightPrice”.

formattedPrice

string

Sformatowana cena, która może zawierać dowolne znaki. Jeśli jest ustawiony, będzie używany zamiast atrybutu „cena” [price], np. „Od 100, 00 PLN”.

formattedSalePrice

string

Sformatowana cena promocyjna, która może zawierać dowolne znaki. Jeśli jest ustawiony, będzie używany zamiast atrybutu „cena promocyjna”, np. „Wyprzedaż 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 jest ustawione, musi też być obecne pole iosAppLink.

similarDestinationIds[]

string

Identyfikatory podobnych miejsc docelowych, np. PAR,LON.

customMapping

string

Pole niestandardowe, które może zawierać wiele kluczy do mapowania wartości rozdzielonych separatorami („,”, „|” i „":"”), w postaci „: , , ... , | : , ... , | ... | : , ... ,”, np. wifi: większość | samolot: 320, 77W 111.

DiscoveryCarouselCardAsset

Zasób karty karuzeli Discovery.

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

string

Nazwa zasobu zasobu powiązanego obrazu marketingowego w formacie 1,91:1. Ten lub kwadratowy komponent z obrazem marketingowym jest wymagany.

squareMarketingImageAsset

string

Nazwa zasobu zasobu powiązanego kwadratowego obrazu marketingowego. Ten lub komponent z obrazem marketingowym jest wymagany.

portraitMarketingImageAsset

string

Nazwa zasobu zasobu powiązanego z pionowym obrazem marketingowym w formacie 4:5.

headline

string

To pole jest wymagane. Nagłówek karty karuzeli.

callToActionText

string

Tekst wezwania do działania.

DynamicTravelAsset

Dynamiczny zasób związany z podróżami.

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

To pole jest wymagane. Identyfikator miejsca docelowego, który może być dowolną sekwencją liter i cyfr oraz musi być niepowtarzalny i pasować do wartości tagu remarketingowego. To pole jest wymagane.

originId

string

Identyfikator punktu początkowego, który może być dowolnym ciągiem liter i cyfr. Sekwencja identyfikatorów (identyfikator miejsca docelowego + identyfikator punktu początkowego) musi być niepowtarzalna.

title

string

To pole jest wymagane. Tytuł, na przykład „Zarezerwuj bilet kolejowy”. To pole jest wymagane.

destinationName

string

Nazwa miejsca docelowego, na przykład Paryż.

destinationAddress

string

Adres miejsca docelowego, który można podać w jednym z poniższych formatów. (1) Miasto, stan, kod, kraj, np. Mountain View, CA, USA. (2) Pełny adres, na przykład ul. Główna 123, Warszawa, Polska. (3) Długość i szerokość geograficzna w zapisie dziesiętnym (DDD), na przykład 41.40338, 2.17403.

originName

string

Nazwa punktu początkowego, np. Londyn.

price

string

Cena, która może być liczbą, po której następuje kod waluty zgodny ze standardem ISO 4217. Użyj kropki jako znaku dziesiętnego, np. 100.00 PLN.

salePrice

string

Cena promocyjna, która może być liczbą, po której następuje kod waluty, według normy ISO 4217. Użyj kropki jako znaku dziesiętnego, np. 80.00 PLN. Wartość musi być mniejsza niż wartość w polu „cena”.

formattedPrice

string

Sformatowana cena, która może zawierać dowolne znaki. Jeśli jest ustawiony, będzie używany zamiast atrybutu „cena” [price], np. „Od 100, 00 PLN”.

formattedSalePrice

string

Sformatowana cena promocyjna, która może zawierać dowolne znaki. Jeśli jest ustawiony, będzie używany zamiast atrybutu „cena promocyjna”, np. „Wyprzedaż za 80, 00 PLN”.

category

string

Kategoria, np. Ekspresowa.

contextualKeywords[]

string

Kontekstowe słowa kluczowe, np. „Paryż pociągi”.

similarDestinationIds[]

string

Identyfikatory podobnych miejsc docelowych, np. Warszawa.

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 jest ustawione, musi też być obecne pole iosAppLink.

DynamicLocalAsset

Dynamiczny zasób lokalny.

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

To pole jest wymagane. Identyfikator umowy, który może być dowolną sekwencją liter i cyfr oraz musi być niepowtarzalny i pasować do wartości tagu remarketingowego. To pole jest wymagane.

dealName

string

To pole jest wymagane. Nazwa oferty, na przykład 50% zniżki w sklepach spożywczych w Warszawie. To pole jest wymagane.

subtitle

string

podtytułu, np. Zakupy spożywcze;

description

string

Opis, np. „Oszczędzaj na cotygodniowym rachunku”.

price

string

Cena, która może być liczbą, po której następuje kod waluty zgodny ze standardem ISO 4217. Użyj kropki jako znaku dziesiętnego, np. 100.00 PLN.

salePrice

string

Cena promocyjna, która może być liczbą, po której następuje kod waluty w kolejności alfabetycznej, według normy ISO 4217. Użyj kropki jako znaku dziesiętnego, np. 80.00 PLN. Wartość musi być mniejsza niż wartość w polu „cena”.

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 poniższych formatów. (1) Miasto, stan, kod, kraj, np. Mountain View, CA, USA. (2) Pełny adres, na przykład ul. Główna 123, Warszawa, Polska. (3) Długość i szerokość geograficzna w zapisie dziesiętnym (DDD), na przykład 41.40338, 2.17403.

category

string

Kategoria, na przykład Jedzenie.

contextualKeywords[]

string

kontekstowych słów kluczowych, np. kupony rabatowe na artykuły spożywcze.

formattedPrice

string

Sformatowana cena, która może zawierać dowolne znaki. Jeśli jest ustawiony, będzie używany zamiast atrybutu „cena” [price], np. „Od 100, 00 PLN”.

formattedSalePrice

string

Sformatowana cena promocyjna, która może zawierać dowolne znaki. Jeśli jest ustawiony, będzie używany zamiast atrybutu „cena promocyjna”, np. „Wyprzedaż 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 jest ustawione, musi też być obecne pole iosAppLink.

DynamicJobsAsset

Dynamiczny zasób ofert pracy.

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

To pole jest wymagane. Identyfikator zadania, który może być dowolną sekwencją liter i cyfr oraz musi być niepowtarzalny i pasować do wartości tagu remarketingowego. To pole jest 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

To pole jest wymagane. Stanowisko, na przykład „Inżynier oprogramowania”. To pole jest wymagane.

jobSubtitle

string

Podtytuł stanowiska, na przykład Poziom II.

description

string

Opis, np. „Zastosuj swoje 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 stanowiska, np. Technika.

contextualKeywords[]

string

Kontekstowe słowa kluczowe, np. Praca inżynierii oprogramowania.

address

string

Adres, który można podać w jednym z poniższych formatów. (1) Miasto, stan, kod, kraj, np. Mountain View, CA, USA. (2) Pełny adres, na przykład ul. Główna 123, Warszawa, Polska. (3) Długość i szerokość geograficzna w zapisie dziesiętnym (DDD), na przykład 41.40338, 2.17403.

salary

string

Wynagrodzenie, np. 100 tys. zł.

similarJobIds[]

string

Identyfikatory podobnych zadań, 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 jest ustawione, musi też być obecne pole iosAppLink.

LocationAsset

Komponent z lokalizacją.

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

string

Identyfikatory miejsc jednoznacznie identyfikują dane 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 miejsca znajdziesz na stronie https://developers.google.com/places/web-service/place-id.

businessProfileLocations[]

object (BusinessProfileLocation)

Lista lokalizacji firmy klienta. Ta wartość będzie zwracana tylko wtedy, gdy komponent z lokalizacją jest synchronizowany z kontem w Profilu Firmy. Na tym samym koncie może być wiele wizytówek w Profilu Firmy i mających ten sam identyfikator miejsca.

locationOwnershipType

enum (LocationOwnershipType)

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

BusinessProfileLocation

Dane o lokalizacji profilu firmy są synchronizowane z połączonego konta w usłudze Profil Firmy.

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

string

Reklamodawca określił etykietę lokalizacji na koncie w Profilu Firmy. Te informacje są synchronizowane z konta w Profilu Firmy.

storeCode

string

Kod sklepu w Profilu Firmy dla tej lokalizacji. Te informacje są synchronizowane z konta w Profilu Firmy.

listingId

string (int64 format)

Identyfikator wizytówki w tej lokalizacji w Profilu Firmy. Te dane są synchronizowane z połączonego konta w usłudze Profil Firmy.

HotelPropertyAsset

Komponent typu hotel.

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

string

Identyfikatory miejsc jednoznacznie identyfikują dane 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.