REST Resource: customers.ads

{
  "resourceName": string,
  "finalUrls": [
    string
  ],
  "finalAppUrls": [
    {
      object (FinalAppUrl)
    }
  ],
  "finalMobileUrls": [
    string
  ],
  "urlCustomParameters": [
    {
      object (CustomParameter)
    }
  ],
  "type": enum (AdType),
  "devicePreference": enum (Device),
  "urlCollections": [
    {
      object (UrlCollection)
    }
  ],
  "systemManagedResourceSource": enum (SystemManagedResourceSource),
  "id": string,
  "trackingUrlTemplate": string,
  "finalUrlSuffix": string,
  "displayUrl": string,
  "addedByGoogleAds": boolean,
  "name": string,

  // Union field ad_data can be only one of the following:
  "textAd": {
    object (TextAdInfo)
  },
  "expandedTextAd": {
    object (ExpandedTextAdInfo)
  },
  "callAd": {
    object (CallAdInfo)
  },
  "expandedDynamicSearchAd": {
    object (ExpandedDynamicSearchAdInfo)
  },
  "hotelAd": {
    object (HotelAdInfo)
  },
  "shoppingSmartAd": {
    object (ShoppingSmartAdInfo)
  },
  "shoppingProductAd": {
    object (ShoppingProductAdInfo)
  },
  "imageAd": {
    object (ImageAdInfo)
  },
  "videoAd": {
    object (VideoAdInfo)
  },
  "videoResponsiveAd": {
    object (VideoResponsiveAdInfo)
  },
  "responsiveSearchAd": {
    object (ResponsiveSearchAdInfo)
  },
  "legacyResponsiveDisplayAd": {
    object (LegacyResponsiveDisplayAdInfo)
  },
  "appAd": {
    object (AppAdInfo)
  },
  "legacyAppInstallAd": {
    object (LegacyAppInstallAdInfo)
  },
  "responsiveDisplayAd": {
    object (ResponsiveDisplayAdInfo)
  },
  "localAd": {
    object (LocalAdInfo)
  },
  "displayUploadAd": {
    object (DisplayUploadAdInfo)
  },
  "appEngagementAd": {
    object (AppEngagementAdInfo)
  },
  "shoppingComparisonListingAd": {
    object (ShoppingComparisonListingAdInfo)
  },
  "smartCampaignAd": {
    object (SmartCampaignAdInfo)
  },
  "appPreRegistrationAd": {
    object (AppPreRegistrationAdInfo)
  },
  "discoveryMultiAssetAd": {
    object (DiscoveryMultiAssetAdInfo)
  },
  "discoveryCarouselAd": {
    object (DiscoveryCarouselAdInfo)
  },
  "discoveryVideoResponsiveAd": {
    object (DiscoveryVideoResponsiveAdInfo)
  },
  "travelAd": {
    object (TravelAdInfo)
  }
  // End of list of possible types for union field ad_data.
}

string

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

customers/{customerId}/ads/{ad_id}

string

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

object (FinalAppUrl)

Lista końcowych adresów URL aplikacji, które będą używane na urządzeniu mobilnym, jeśli użytkownik ma zainstalowaną określoną aplikację.

string

Lista możliwych końcowych adresów URL dla urządzeń mobilnych po wszystkich przekierowaniach między domenami w przypadku reklamy.

object (CustomParameter)

Lista mapowań, których można używać do zastępowania tagów parametrów niestandardowych w tagach trackingUrlTemplate, finalUrls lub mobile_final_urls. W przypadku mutacji używaj operacji na niestandardowych parametrach URL.

enum (AdType)

Tylko dane wyjściowe. Typ reklamy.

enum (Device)

Preferowane urządzenia dla reklamy. To ustawienie możesz określić tylko dla urządzeń mobilnych. Gdy to ustawienie jest włączone, reklama podczas wyświetlania na urządzeniu mobilnym ma pierwszeństwo przed innymi reklamami. Reklama może się nadal wyświetlać na urządzeniach innych typów, np. wtedy, gdy nie są dostępne żadne inne reklamy. Jeśli nie określisz tego ustawienia (brak ustawienia urządzenia), kierowanie będzie na niego kierowane na wszystkie urządzenia. Ta opcja jest obsługiwana tylko przez niektóre typy reklam.

object (UrlCollection)

Dodatkowe adresy URL reklamy, które są oznaczone unikalnym identyfikatorem, do którego można się odwoływać z innych pól w reklamie.

enum (SystemManagedResourceSource)

Tylko dane wyjściowe. Jeśli reklama jest zarządzana przez system, to pole wskazuje źródło. To pole jest tylko do odczytu.

string (int64 format)

Tylko dane wyjściowe. Identyfikator reklamy.

string

Szablon adresu URL służący do tworzenia linku monitorującego.

string

Sufiks, którego należy użyć podczas tworzenia końcowego adresu URL.

string

Adres URL widoczny w tekście reklamy w przypadku niektórych formatów reklam.

boolean

Tylko dane wyjściowe. Wskazuje, czy reklama została automatycznie dodana przez Google Ads, a nie przez użytkownika. Może się tak zdarzyć, jeśli reklamy są tworzone automatycznie jako propozycje nowych reklam na podstawie informacji o skuteczności dotychczasowych reklam.

string

Stałe. Nazwa reklamy. Dane te służą tylko do identyfikacji reklamy. Nie musi być niepowtarzalna i nie ma wpływu na wyświetlaną reklamę. Pole nazwy jest obecnie obsługiwane tylko w przypadku reklam DisplayUploadAd, ImageAd, ShoppingComparisonListingAd i VideoAd.

object (TextAdInfo)

Stałe. Szczegóły dotyczące reklamy tekstowej.

object (ExpandedTextAdInfo)

Szczegóły dotyczące rozszerzonej reklamy tekstowej.

object (CallAdInfo)

Szczegóły dotyczące reklamy generującej połączenia.

object (ExpandedDynamicSearchAdInfo)

Stałe. Szczegóły dotyczące rozszerzonej dynamicznej reklamy w wyszukiwarce. Ten typ reklamy ma nagłówek oraz końcowe i wyświetlany adres URL generowane automatycznie podczas wyświetlania zgodnie z informacjami dotyczącymi nazwy domeny podanymi przez usługę dynamicSearchAdsSetting, które są połączone na poziomie kampanii.

object (HotelAdInfo)

Szczegóły dotyczące reklamy hotelu.

object (ShoppingSmartAdInfo)

Szczegóły dotyczące inteligentnej reklamy produktowej.

object (ShoppingProductAdInfo)

Szczegóły dotyczące reklamy produktowej.

object (ImageAdInfo)

Stałe. Szczegóły dotyczące reklamy graficznej.

object (VideoAdInfo)

Szczegóły dotyczące reklamy wideo.

object (VideoResponsiveAdInfo)

Szczegóły dotyczące elastycznej reklamy wideo.

object (ResponsiveSearchAdInfo)

Szczegóły elastycznej reklamy w wyszukiwarce.

object (LegacyResponsiveDisplayAdInfo)

Szczegóły dotyczące starszej elastycznej reklamy displayowej.

object (AppAdInfo)

Szczegóły reklamy aplikacji.

object (LegacyAppInstallAdInfo)

Stałe. Szczegóły dotyczące starszej reklamy promującej instalacje aplikacji.

object (ResponsiveDisplayAdInfo)

Szczegóły elastycznej reklamy displayowej.

object (LocalAdInfo)

Szczegóły dotyczące reklamy lokalnej.

object (DisplayUploadAdInfo)

Szczegóły dotyczące przesyłanej reklamy displayowej.

object (AppEngagementAdInfo)

Szczegóły reklamy angażującej w aplikację.

object (ShoppingComparisonListingAdInfo)

Szczegóły dotyczące reklamy z porównaniem produktów.

object (SmartCampaignAdInfo)

Szczegóły dotyczące reklamy z kampanii inteligentnej.

object (AppPreRegistrationAdInfo)

Szczegóły dotyczące reklamy promującej wcześniejszą rejestrację na aplikację.

object (DiscoveryMultiAssetAdInfo)

Szczegóły dotyczące reklamy Discovery z wieloma komponentami.

object (DiscoveryCarouselAdInfo)

Szczegóły reklamy karuzelowej Discovery.

object (DiscoveryVideoResponsiveAdInfo)

Szczegóły dotyczące elastycznej reklamy wideo Discovery.

object (TravelAdInfo)

Szczegóły dotyczące reklamy biura podróży.

{
  "osType": enum (AppUrlOperatingSystemType),
  "url": string
}

enum (AppUrlOperatingSystemType)

System operacyjny, na który kierowany jest ten adres URL. To pole jest wymagane.

string

URL precyzyjnego linku do aplikacji. Precyzyjne linki określają lokalizację w aplikacji odpowiadającą treści, którą chcesz wyświetlać. Schemat powinien mieć postać {schemat}://{ścieżka_hosta}. Schemat wskazuje, którą aplikację należy otworzyć. W przypadku swojej aplikacji możesz użyć schematu niestandardowego, który zaczyna się od jej nazwy. Host i ścieżka określają unikalną lokalizację Twojej treści w aplikacji. Przykład: „przykladowaaplikacja://identyfikatorproduktu_1234”. To pole jest wymagane.

{
  "key": string,
  "value": string
}

string

Klucz pasujący do nazwy tagu parametru.

string

Wartość do zastąpienia.

{
  "finalUrls": [
    string
  ],
  "finalMobileUrls": [
    string
  ],
  "urlCollectionId": string,
  "trackingUrlTemplate": string
}

string

Lista możliwych końcowych adresów URL.

string

Lista możliwych końcowych adresów URL na urządzenia mobilne.

string

Unikalny identyfikator tej instancji UrlCollection.

string

Szablon URL do tworzenia linku monitorującego.

{
  "headline": string,
  "description1": string,
  "description2": string
}

string

Nagłówek reklamy.

string

Pierwszy wiersz tekstu reklamy.

string

Drugi wiersz tekstu reklamy.

{
  "headlinePart1": string,
  "headlinePart2": string,
  "headlinePart3": string,
  "description": string,
  "description2": string,
  "path1": string,
  "path2": string
}

string

Pierwsza część nagłówka reklamy.

string

Druga część nagłówka reklamy.

string

Trzecia część nagłówka reklamy.

string

Opis reklamy.

string

Drugi tekst reklamy.

string

Tekst, który może się wyświetlać obok wyświetlanego adresu URL reklamy.

string

Dodatkowy tekst, który może pojawić się obok wyświetlanego adresu URL reklamy.

{
  "countryCode": string,
  "phoneNumber": string,
  "businessName": string,
  "headline1": string,
  "headline2": string,
  "description1": string,
  "description2": string,
  "callTracked": boolean,
  "disableCallConversion": boolean,
  "phoneNumberVerificationUrl": string,
  "conversionAction": string,
  "conversionReportingState": enum (CallConversionReportingState),
  "path1": string,
  "path2": string
}

string

Kod kraju w reklamie.

string

Numer telefonu w reklamie.

string

Nazwa firmy w reklamie.

string

Pierwszy nagłówek reklamy.

string

Drugi nagłówek reklamy.

string

Pierwszy wiersz tekstu reklamy.

string

Drugi wiersz tekstu reklamy.

boolean

Określa, czy włączyć śledzenie połączeń dla kreacji. Włączenie śledzenia połączeń powoduje też włączenie konwersji telefonicznych.

boolean

Określa, czy chcesz wyłączyć konwersje telefoniczne dla kreacji. Jeśli zasada ma wartość true, konwersje telefoniczne są wyłączone, nawet jeśli callTracked ma wartość true. Jeśli callTracked ma wartość false, to pole jest ignorowane.

string

Adres URL do weryfikacji numeru telefonu.

string

Działanie powodujące konwersję, do którego przypisać konwersję telefoniczną. Jeśli zasada jest nieskonfigurowana, używane jest domyślne działanie powodujące konwersję. To pole ma zastosowanie tylko wtedy, gdy callTracked ma wartość true. W przeciwnym razie pole jest ignorowane.

enum (CallConversionReportingState)

Działanie konwersji telefonicznej w przypadku tej reklamy generującej połączenia. Może używać własnego ustawienia konwersji telefonicznych, dziedziczyć ustawienie z poziomu konta albo być wyłączona.

string

Pierwsza część tekstu, którą można dołączyć do adresu URL w reklamie. Opcjonalnie.

string

Druga część tekstu, którą można dołączyć do adresu URL w reklamie. To pole można skonfigurować tylko wtedy, gdy ustawiono też path1. Opcjonalnie.

{
  "description": string,
  "description2": string
}

string

Opis reklamy.

string

Drugi tekst reklamy.

{
  "mimeType": enum (MimeType),
  "pixelWidth": string,
  "pixelHeight": string,
  "imageUrl": string,
  "previewPixelWidth": string,
  "previewPixelHeight": string,
  "previewImageUrl": string,
  "name": string,

  // Union field image can be only one of the following:
  "mediaFile": string,
  "data": string,
  "adIdToCopyImageFrom": string
  // End of list of possible types for union field image.
}

enum (MimeType)

Typ MIME obrazu.

string (int64 format)

Szerokość obrazu w pełnym rozmiarze w pikselach.

string (int64 format)

Wysokość obrazu w pełnym rozmiarze (w pikselach).

string

Adres URL obrazu w pełnym rozmiarze.

string (int64 format)

Szerokość obrazu rozmiaru podglądu w pikselach.

string (int64 format)

Wysokość obrazu rozmiaru podglądu w pikselach.

string

Adres URL obrazu rozmiaru podglądu.

string

Nazwa obrazu. Jeśli obraz został utworzony na podstawie elementu MediaFile, jest to nazwa elementu MediaFile. Jeśli obraz został utworzony z bajtów, to pole jest puste.

string

Zasób MediaFile, który ma być używany w przypadku obrazu.

string (bytes format)

Nieprzetworzone dane obrazu w bajtach.

Ciąg zakodowany w standardzie base64.

string (int64 format)

Identyfikator reklamy, z której chcesz skopiować obraz.

{
  "video": {
    object (AdVideoAsset)
  },

  // Union field format can be only one of the following:
  "inStream": {
    object (VideoTrueViewInStreamAdInfo)
  },
  "bumper": {
    object (VideoBumperInStreamAdInfo)
  },
  "outStream": {
    object (VideoOutstreamAdInfo)
  },
  "nonSkippable": {
    object (VideoNonSkippableInStreamAdInfo)
  },
  "inFeed": {
    object (InFeedVideoAdInfo)
  }
  // End of list of possible types for union field format.
}

object (AdVideoAsset)

Komponenty wideo w YouTube użyte w reklamie.

object (VideoTrueViewInStreamAdInfo)

Format reklamy wideo TrueView In-Stream.

object (VideoBumperInStreamAdInfo)

Format reklamy In-Stream w bumperze wideo.

object (VideoOutstreamAdInfo)

Format reklamy wideo Out-Stream.

object (VideoNonSkippableInStreamAdInfo)

Format reklamy wideo In-Stream niemożliwej do pominięcia.

object (InFeedVideoAdInfo)

Format reklamy wideo In-Feed.

{
  "asset": string
}

string

Nazwa zasobu tego filmu.

{
  "actionButtonLabel": string,
  "actionHeadline": string,
  "companionBanner": {
    object (AdImageAsset)
  }
}

string

Etykieta przycisku wezwania do działania, który przekierowuje użytkownika do końcowego adresu URL reklamy wideo. Wymagane w kampaniach TrueView zachęcających do działania. W przeciwnym razie są opcjonalne.

string

Dodatkowy tekst z przyciskiem wezwania do działania, który informuje o kontekście i zachęca do kliknięcia przycisku.

object (AdImageAsset)

Komponenty z obrazem banera towarzyszącego użyte w reklamie.

{
  "asset": string
}

string

Nazwa zasobu danego obrazu.

{
  "companionBanner": {
    object (AdImageAsset)
  },
  "actionButtonLabel": string,
  "actionHeadline": string
}

object (AdImageAsset)

Komponenty z obrazem banera towarzyszącego użyte w reklamie.

string

Etykieta przycisku „Wezwanie do działania”, która przekierowuje użytkownika do końcowego adresu URL reklamy wideo.

string

Dodatkowy tekst z przyciskiem wezwania do działania, który informuje o kontekście i zachęca do kliknięcia przycisku.

{
  "headline": string,
  "description": string
}

string

Nagłówek reklamy.

string

Linia tekstu.

{
  "companionBanner": {
    object (AdImageAsset)
  },
  "actionButtonLabel": string,
  "actionHeadline": string
}

object (AdImageAsset)

Komponenty z obrazem banera towarzyszącego użyte w reklamie.

string

Etykieta przycisku „Wezwanie do działania”, która przekierowuje użytkownika do końcowego adresu URL reklamy wideo.

string

Dodatkowy tekst z przyciskiem „Wezwanie do działania”, który informuje o kontekście i zachęca do kliknięcia przycisku.

{
  "headline": string,
  "description1": string,
  "description2": string,
  "thumbnail": enum (VideoThumbnail)
}

string

Nagłówek reklamy.

string

Pierwszy wiersz tekstu reklamy.

string

Drugi wiersz tekstu reklamy.

enum (VideoThumbnail)

Obraz miniatury filmu do użycia.

{
  "headlines": [
    {
      object (AdTextAsset)
    }
  ],
  "longHeadlines": [
    {
      object (AdTextAsset)
    }
  ],
  "descriptions": [
    {
      object (AdTextAsset)
    }
  ],
  "callToActions": [
    {
      object (AdTextAsset)
    }
  ],
  "videos": [
    {
      object (AdVideoAsset)
    }
  ],
  "companionBanners": [
    {
      object (AdImageAsset)
    }
  ],
  "breadcrumb1": string,
  "breadcrumb2": string
}

object (AdTextAsset)

Lista komponentów tekstowych używanych w krótkim nagłówku. Obecnie obsługiwana jest tylko jedna wartość krótkiego nagłówka.

object (AdTextAsset)

Lista komponentów tekstowych używanych w długim nagłówku. Obecnie obsługiwana jest tylko jedna wartość dla długiego nagłówka.

object (AdTextAsset)

Lista komponentów tekstowych użytych w tekście reklamy. Obecnie obsługiwana jest tylko jedna wartość opisu.

object (AdTextAsset)

Lista komponentów tekstowych użytych w przypadku tego przycisku, np. przycisku „Wezwanie do działania”. Obecnie obsługiwana jest tylko jedna wartość przycisku.

object (AdVideoAsset)

Lista komponentów wideo w YouTube użytych w reklamie. Obecnie obsługiwana jest tylko jedna wartość dla zasobu wideo w YouTube.

object (AdImageAsset)

Lista komponentów z obrazem użytych w banerze towarzyszącym. Obecnie obsługiwana jest tylko jedna wartość zasobu banera towarzyszącego.

string

Pierwsza część tekstu pojawiającego się w reklamie razem z wyświetlanym adresem URL.

string

Druga część tekstu pojawiająca się w reklamie razem z wyświetlanym adresem URL.

{
  "pinnedField": enum (ServedAssetFieldType),
  "assetPerformanceLabel": enum (AssetPerformanceLabel),
  "policySummaryInfo": {
    object (AdAssetPolicySummary)
  },
  "text": string
}

enum (ServedAssetFieldType)

Przypięte pole zasobu. Dzięki temu komponent będzie wyświetlany tylko w tym polu. Do tego samego pola można przypiąć wiele zasobów. Komponent, który jest przypięty lub przypięty do innego pola, nie będzie się wyświetlać w polu, w którym przypięto inny komponent.

enum (AssetPerformanceLabel)

Etykieta skuteczności zasobu tekstowego.

object (AdAssetPolicySummary)

Podsumowanie zasad dotyczących tego komponentu tekstowego.

string

Tekst komponentu.

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

object (PolicyTopicEntry)

Lista wyników dotyczących zasad dla tego zasobu.

enum (PolicyReviewStatus)

W którym miejscu w procesie weryfikacji ten komponent

enum (PolicyApprovalStatus)

Ogólny stan zatwierdzenia danego zasobu, obliczany na podstawie stanu poszczególnych wpisów tematu zasad.

{
  "type": enum (PolicyTopicEntryType),
  "evidences": [
    {
      object (PolicyTopicEvidence)
    }
  ],
  "constraints": [
    {
      object (PolicyTopicConstraint)
    }
  ],
  "topic": string
}

enum (PolicyTopicEntryType)

Opisuje negatywny lub pozytywny wpływ tej zasady na wyświetlanie reklam.

object (PolicyTopicEvidence)

dodatkowe informacje wyjaśniające wynik wyszukiwania zasad (np. nazwa marki w przypadku wyniku wyszukiwania);

object (PolicyTopicConstraint)

Określa, jak może to wpłynąć na wyświetlanie tego zasobu (np. nie jest on wyświetlany w danym kraju).

string

Temat dotyczący zasad, do którego odnosi się ten wynik. Na przykład „ALCOHOL”, „TRADEMARKS_IN_AD_TEXT” lub „DESTINATION_NOT_WORKING”. Zestaw możliwych tematów zasad nie jest ustalony dla konkretnej wersji interfejsu API i może się zmienić w dowolnym momencie.

{

  // Union field value can be only one of the following:
  "websiteList": {
    object (WebsiteList)
  },
  "textList": {
    object (TextList)
  },
  "languageCode": string,
  "destinationTextList": {
    object (DestinationTextList)
  },
  "destinationMismatch": {
    object (DestinationMismatch)
  },
  "destinationNotWorking": {
    object (DestinationNotWorking)
  }
  // End of list of possible types for union field value.
}

object (WebsiteList)

Lista stron internetowych połączonych z tym zasobem.

object (TextList)

Lista dowodów znalezionych w tekście zasobu.

string

Język, w którym został wykryty zasób. Jest to tag języka IETF, taki jak „pl-PL”.

object (DestinationTextList)

Tekst w miejscu docelowym zasobu, który powoduje znalezienie zasady.

object (DestinationMismatch)

Niezgodność między miejscami docelowymi adresów URL zasobów.

object (DestinationNotWorking)

Szczegółowe informacje o tym, że miejsce docelowe zwraca kod błędu HTTP lub nie działa w niektórych lokalizacjach na popularnych urządzeniach.

{
  "websites": [
    string
  ]
}

string

Witryny, w których wystąpił problem dotyczący zasad.

{
  "texts": [
    string
  ]
}

string

Fragmenty tekstu z zasobu, które spowodowały znalezienie zasady.

{
  "destinationTexts": [
    string
  ]
}

string

Lista tekstu znalezionego na stronie docelowej zasobu.

{
  "urlTypes": [
    enum (PolicyTopicEvidenceDestinationMismatchUrlType)
  ]
}

enum (PolicyTopicEvidenceDestinationMismatchUrlType)

Zbiór adresów URL, które nie pasowały do siebie.

{
  "device": enum (PolicyTopicEvidenceDestinationNotWorkingDevice),
  "expandedUrl": string,
  "lastCheckedDateTime": string,

  // Union field reason can be only one of the following:
  "dnsErrorType": enum (PolicyTopicEvidenceDestinationNotWorkingDnsErrorType),
  "httpErrorCode": string
  // End of list of possible types for union field reason.
}

enum (PolicyTopicEvidenceDestinationNotWorkingDevice)

Typ urządzenia, na którym nie udało się wczytać adresu URL.

string

Pełny adres URL, który nie zadziałał.

string

Czas ostatniego sprawdzenia adresu URL. Format to „RRRR-MM-DD GG:MM:SS”. Przykłady: „2018-03-05 09:15:00” lub „2018-02-01 14:34:30”.

enum (PolicyTopicEvidenceDestinationNotWorkingDnsErrorType)

Typ błędu DNS.

string (int64 format)

Kod błędu HTTP.

{

  // Union field value can be only one of the following:
  "countryConstraintList": {
    object (CountryConstraintList)
  },
  "resellerConstraint": {
    object (ResellerConstraint)
  },
  "certificateMissingInCountryList": {
    object (CountryConstraintList)
  },
  "certificateDomainMismatchInCountryList": {
    object (CountryConstraintList)
  }
  // End of list of possible types for union field value.
}

object (CountryConstraintList)

Kraje, w których zasób nie może być wyświetlany.

object (ResellerConstraint)

Ograniczenie dotyczące sprzedawcy.

object (CountryConstraintList)

Kraje, w których do wyświetlania reklam wymagany jest certyfikat.

object (CountryConstraintList)

Kraje, w których domena zasobu nie jest objęta powiązanymi z nim certyfikatami.

{
  "countries": [
    {
      object (CountryConstraint)
    }
  ],
  "totalTargetedCountries": integer
}

object (CountryConstraint)

Kraje, w których wyświetlanie jest ograniczone.

integer

Łączna liczba krajów, na które kierowany jest zasób.

{
  "countryCriterion": string
}

string

Nazwa stałego zasobu kierowania geograficznego w kraju, w którym wyświetlanie jest ograniczone.

{
  "headlines": [
    {
      object (AdTextAsset)
    }
  ],
  "descriptions": [
    {
      object (AdTextAsset)
    }
  ],
  "path1": string,
  "path2": string
}

object (AdTextAsset)

Lista komponentów tekstowych dla nagłówków. Przy wyświetlaniu reklamy nagłówki zostaną wybrane z tej listy.

object (AdTextAsset)

Lista komponentów tekstowych do tekstów reklam. Podczas wyświetlania reklamy zostaną wybrane teksty reklamy z tej listy.

string

Pierwsza część tekstu, którą można dołączyć do adresu URL w reklamie.

string

Druga część tekstu, którą można dołączyć do adresu URL w reklamie. To pole można skonfigurować tylko wtedy, gdy ustawiono też path1.

{
  "formatSetting": enum (DisplayAdFormatSetting),
  "shortHeadline": string,
  "longHeadline": string,
  "description": string,
  "businessName": string,
  "allowFlexibleColor": boolean,
  "accentColor": string,
  "mainColor": string,
  "callToActionText": string,
  "logoImage": string,
  "squareLogoImage": string,
  "marketingImage": string,
  "squareMarketingImage": string,
  "pricePrefix": string,
  "promoText": string
}

enum (DisplayAdFormatSetting)

Określa format, w jakim reklama będzie wyświetlana. Wartość domyślna to ALL_FORMATS.

string

Krótka wersja nagłówka reklamy.

string

Długa wersja nagłówka reklamy.

string

Opis reklamy.

string

Nazwa firmy w reklamie.

boolean

Zgoda reklamodawcy na wybór dowolnego koloru. Jeśli ma wartość true (prawda), reklama może w razie potrzeby być wyświetlana w innym kolorze. Jeśli ustawisz wartość false (fałsz), reklama będzie wyświetlana w określonych kolorach lub w neutralnym kolorze. Wartością domyślną jest true. Ta wartość musi mieć wartość prawda, jeśli wartości mainColor i accentColor nie są ustawione.

string

Kolor uzupełniający reklamy w postaci liczby szesnastkowej, np. #FF w przypadku białego koloru. Jeśli wartość mainColor i accentColor jest ustawiona, druga też jest wymagana.

string

Główny kolor reklamy w zapisie szesnastkowym, np. #FF w przypadku białego koloru. Jeśli wartość mainColor i accentColor jest ustawiona, druga też jest wymagana.

string

Tekst wezwania do działania w reklamie.

string

Nazwa zasobu MediaFile obrazu logo użytego w reklamie.

string

Nazwa zasobu MediaFile kwadratowego obrazu logo użytego w reklamie.

string

Nazwa zasobu MediaFile obrazu marketingowego użytego w reklamie.

string

Nazwa zasobu MediaFile kwadratowego obrazu marketingowego użytego w reklamie.

string

Prefiks przed ceną. Na przykład: „jak”.

string

Tekst promocyjny używany w formatach dynamicznych reklam elastycznych. na przykład „Bezpłatna dostawa w 2 dni”.

{
  "mandatoryAdText": {
    object (AdTextAsset)
  },
  "headlines": [
    {
      object (AdTextAsset)
    }
  ],
  "descriptions": [
    {
      object (AdTextAsset)
    }
  ],
  "images": [
    {
      object (AdImageAsset)
    }
  ],
  "youtubeVideos": [
    {
      object (AdVideoAsset)
    }
  ],
  "html5MediaBundles": [
    {
      object (AdMediaBundleAsset)
    }
  ]
}

object (AdTextAsset)

Obowiązkowy tekst reklamy.

object (AdTextAsset)

Lista komponentów tekstowych dla nagłówków. Przy wyświetlaniu reklamy nagłówki zostaną wybrane z tej listy.

object (AdTextAsset)

Lista komponentów tekstowych do tekstów reklam. Podczas wyświetlania reklamy zostaną wybrane teksty reklamy z tej listy.

object (AdImageAsset)

Lista komponentów z obrazem, które mogą wyświetlać się w reklamie.

object (AdVideoAsset)

Lista komponentów wideo w YouTube, które mogą wyświetlać się w reklamie.

object (AdMediaBundleAsset)

Lista zasobów pakietu kreacji multimedialnych, które mogą być używane w reklamie.

{
  "asset": string
}

string

Nazwa zasobu zasobu tego pakietu kreacji multimedialnych.

{
  "appStore": enum (LegacyAppInstallAdAppStore),
  "appId": string,
  "headline": string,
  "description1": string,
  "description2": string
}

enum (LegacyAppInstallAdAppStore)

Sklep z aplikacjami, w którym dostępna jest aplikacja mobilna.

string

Identyfikator aplikacji mobilnej.

string

Nagłówek reklamy.

string

Pierwsza linia tekstu reklamy.

string

Druga linia tekstu reklamy.

{
  "marketingImages": [
    {
      object (AdImageAsset)
    }
  ],
  "squareMarketingImages": [
    {
      object (AdImageAsset)
    }
  ],
  "logoImages": [
    {
      object (AdImageAsset)
    }
  ],
  "squareLogoImages": [
    {
      object (AdImageAsset)
    }
  ],
  "headlines": [
    {
      object (AdTextAsset)
    }
  ],
  "longHeadline": {
    object (AdTextAsset)
  },
  "descriptions": [
    {
      object (AdTextAsset)
    }
  ],
  "youtubeVideos": [
    {
      object (AdVideoAsset)
    }
  ],
  "formatSetting": enum (DisplayAdFormatSetting),
  "controlSpec": {
    object (ResponsiveDisplayAdControlSpec)
  },
  "businessName": string,
  "mainColor": string,
  "accentColor": string,
  "allowFlexibleColor": boolean,
  "callToActionText": string,
  "pricePrefix": string,
  "promoText": string
}

object (AdImageAsset)

Obrazy marketingowe używane w reklamie. Prawidłowe typy zdjęć to GIF, JPEG i PNG. Minimalny rozmiar to 600 x 314, a współczynnik proporcji 1,91:1 (+-1%). Wymagany jest co najmniej 1 element marketingImage. Po połączeniu z squareMarketingImages maksymalna liczba to 15.

object (AdImageAsset)

Kwadratowe obrazy marketingowe do wykorzystania w reklamie. Prawidłowe typy zdjęć to GIF, JPEG i PNG. Minimalny rozmiar to 300 × 300, a współczynnik proporcji: 1:1 (+-1%). Wymagany jest co najmniej 1 kwadratowy element marketingImage. Po połączeniu z marketingImages maksymalna liczba to 15.

object (AdImageAsset)

Obrazy logo do wykorzystania w reklamie. Prawidłowe typy zdjęć to GIF, JPEG i PNG. Minimalny rozmiar to 512 x 128, a współczynnik proporcji 4:1 (+-1%). Po połączeniu z squareLogoImages maksymalna liczba to 5.

object (AdImageAsset)

Kwadratowe obrazy logo do wykorzystania w reklamie. Prawidłowe typy zdjęć to GIF, JPEG i PNG. Minimalny rozmiar to 128 x 128, a współczynnik proporcji: 1:1 (+-1%). Po połączeniu z logoImages maksymalna liczba to 5.

object (AdTextAsset)

Krótkie nagłówki reklamy. Maksymalna długość to 30 znaków. Możesz określić od 1 do 5 nagłówków.

object (AdTextAsset)

Wymagany długi nagłówek formatu. Maksymalna długość to 90 znaków.

object (AdTextAsset)

Opisy reklam. Maksymalna długość to 90 znaków. Możesz określić od 1 do 5 nagłówków.

object (AdVideoAsset)

Opcjonalne filmy w YouTube na potrzeby reklamy. Można określić maksymalnie 5 filmów.

enum (DisplayAdFormatSetting)

Określa format, w jakim reklama będzie wyświetlana. Wartość domyślna to ALL_FORMATS.

object (ResponsiveDisplayAdControlSpec)

Specyfikacje różnych ustawień kreacji.

string

Nazwa reklamodawcy lub marki. Maksymalna szerokość wyświetlacza to 25.

string

Główny kolor reklamy w zapisie szesnastkowym, np. #FF w przypadku białego koloru. Jeśli wartość mainColor i accentColor jest ustawiona, druga też jest wymagana.

string

Kolor uzupełniający reklamy w postaci liczby szesnastkowej, np. #FF w przypadku białego koloru. Jeśli wartość mainColor i accentColor jest ustawiona, druga też jest wymagana.

boolean

Zgoda reklamodawcy na wybór dowolnego koloru. Jeśli ma wartość true (prawda), reklama może w razie potrzeby być wyświetlana w innym kolorze. Jeśli ustawisz wartość false (fałsz), reklama będzie wyświetlana w określonych kolorach lub w neutralnym kolorze. Wartością domyślną jest true. Ta wartość musi mieć wartość prawda, jeśli wartości mainColor i accentColor nie są ustawione.

string

Tekst wezwania do działania w reklamie. Maksymalna szerokość wyświetlacza to 30.

string

Prefiks przed ceną. Na przykład: „jak”.

string

Tekst promocyjny używany w formatach dynamicznych reklam elastycznych. na przykład „Bezpłatna dostawa w 2 dni”.

{
  "enableAssetEnhancements": boolean,
  "enableAutogenVideo": boolean
}

boolean

Określa, czy reklamodawca włączył funkcję ulepszeń komponentów.

boolean

Określa, czy reklamodawca włączył funkcję automatycznego generowania filmów.

{
  "headlines": [
    {
      object (AdTextAsset)
    }
  ],
  "descriptions": [
    {
      object (AdTextAsset)
    }
  ],
  "callToActions": [
    {
      object (AdTextAsset)
    }
  ],
  "marketingImages": [
    {
      object (AdImageAsset)
    }
  ],
  "logoImages": [
    {
      object (AdImageAsset)
    }
  ],
  "videos": [
    {
      object (AdVideoAsset)
    }
  ],
  "path1": string,
  "path2": string
}

object (AdTextAsset)

Lista komponentów tekstowych dla nagłówków. Przy wyświetlaniu reklamy nagłówki zostaną wybrane z tej listy. Należy określić od 1 do 5 nagłówków.

object (AdTextAsset)

Lista komponentów tekstowych do tekstów reklam. Podczas wyświetlania reklamy zostaną wybrane teksty reklamy z tej listy. Należy określić od 1 do 5 tekstów reklamy.

object (AdTextAsset)

Lista komponentów tekstowych z wezwaniami do działania. Przy wyświetleniu reklamy będą wybierane z tej listy wezwania do działania. Należy określić od 1 do 5 wezwań do działania.

object (AdImageAsset)

Lista komponentów z obrazem marketingowym, które mogą się wyświetlać w reklamie. Obrazy muszą mieć rozmiar 314 x 600 pikseli lub 320 x 320 pikseli. Musisz określić od 1 do 20 komponentów z obrazem.

object (AdImageAsset)

Lista komponentów z obrazem logo, które mogą wyświetlać się w reklamie. Obrazy muszą mieć wymiary 128 x 128 pikseli i nie mogą być większe niż 120 KB. Musisz określić od 1 do 5 komponentów z obrazem.

object (AdVideoAsset)

Lista komponentów wideo w YouTube, które mogą wyświetlać się w reklamie. Musisz określić od 1 do 20 komponentów wideo.

string

Pierwsza część opcjonalnego tekstu, który można dołączyć do adresu URL w reklamie.

string

Druga część opcjonalnego tekstu, który można dołączyć do adresu URL w reklamie. To pole można skonfigurować tylko wtedy, gdy ustawiono też path1.

{
  "displayUploadProductType": enum (DisplayUploadProductType),

  // Union field media_asset can be only one of the following:
  "mediaBundle": {
    object (AdMediaBundleAsset)
  }
  // End of list of possible types for union field media_asset.
}

enum (DisplayUploadProductType)

Typ produktu danej reklamy. Aby uzyskać szczegółowe informacje, zapoznaj się z komentarzami do tej listy.

object (AdMediaBundleAsset)

Zasób pakietu kreacji multimedialnych używany w reklamie. Informacje o pakiecie kreacji multimedialnych na potrzeby kreacji HTML5_UPLOAD_AD znajdziesz na stronie https://support.google.com/google-ads/answer/1722096 Pakiety kreacji multimedialnych należących do typów produktów dynamicznych mają specjalny format, który trzeba utworzyć w aplikacji Google Web Designer. Więcej informacji znajdziesz na stronie https://support.google.com/webdesigner/answer/7543898.

{
  "headlines": [
    {
      object (AdTextAsset)
    }
  ],
  "descriptions": [
    {
      object (AdTextAsset)
    }
  ],
  "images": [
    {
      object (AdImageAsset)
    }
  ],
  "videos": [
    {
      object (AdVideoAsset)
    }
  ]
}

object (AdTextAsset)

Lista komponentów tekstowych dla nagłówków. Przy wyświetlaniu reklamy nagłówki zostaną wybrane z tej listy.

object (AdTextAsset)

Lista komponentów tekstowych do tekstów reklam. Podczas wyświetlania reklamy zostaną wybrane teksty reklamy z tej listy.

object (AdImageAsset)

Lista komponentów z obrazem, które mogą wyświetlać się w reklamie.

object (AdVideoAsset)

Lista komponentów wideo, które mogą wyświetlać się z reklamą.

{
  "headline": string
}

string

Nagłówek reklamy. To pole jest wymagane. Maksymalna dozwolona długość to 25–45 znaków.

{
  "headlines": [
    {
      object (AdTextAsset)
    }
  ],
  "descriptions": [
    {
      object (AdTextAsset)
    }
  ]
}

object (AdTextAsset)

Lista komponentów tekstowych, z których każdy odpowiada nagłówkowi, gdy reklama jest wyświetlana. Lista zawiera od 3 do 15 komponentów tekstowych.

object (AdTextAsset)

Lista komponentów tekstowych, z których każdy odpowiada opisowi podczas wyświetlania reklamy. Lista zawiera od 2 do 4 komponentów tekstowych.

{
  "headlines": [
    {
      object (AdTextAsset)
    }
  ],
  "descriptions": [
    {
      object (AdTextAsset)
    }
  ],
  "images": [
    {
      object (AdImageAsset)
    }
  ],
  "youtubeVideos": [
    {
      object (AdVideoAsset)
    }
  ]
}

object (AdTextAsset)

Lista komponentów tekstowych dla nagłówków. Przy wyświetlaniu reklamy nagłówki zostaną wybrane z tej listy.

object (AdTextAsset)

Lista komponentów tekstowych do tekstów reklam. Podczas wyświetlania reklamy zostaną wybrane teksty reklamy z tej listy.

object (AdImageAsset)

Lista identyfikatorów komponentów z obrazem, których obrazy mogą wyświetlać się w reklamach.

object (AdVideoAsset)

Lista identyfikatorów komponentów wideo w YouTube, których filmy mogą być wyświetlane z reklamą.

{
  "marketingImages": [
    {
      object (AdImageAsset)
    }
  ],
  "squareMarketingImages": [
    {
      object (AdImageAsset)
    }
  ],
  "portraitMarketingImages": [
    {
      object (AdImageAsset)
    }
  ],
  "logoImages": [
    {
      object (AdImageAsset)
    }
  ],
  "headlines": [
    {
      object (AdTextAsset)
    }
  ],
  "descriptions": [
    {
      object (AdTextAsset)
    }
  ],
  "businessName": string,
  "callToActionText": string,
  "leadFormOnly": boolean
}

object (AdImageAsset)

Komponenty z obrazem marketingowym, które mają zostać użyte w reklamie. Prawidłowe typy zdjęć to GIF, JPEG i PNG. Minimalny rozmiar to 600 x 314, a współczynnik proporcji 1,91:1 (+-1%). Wymagany, jeśli nie ma elementu SquareMarketingImages. Suma wartości squareMarketingImages i portraitMarketingImages daje maksymalnie 20.

object (AdImageAsset)

Kwadratowe komponenty z obrazem marketingowym, które zostaną użyte w reklamie. Prawidłowe typy zdjęć to GIF, JPEG i PNG. Minimalny rozmiar to 300 × 300, a współczynnik proporcji: 1:1 (+-1%). Wymagany, jeśli nie ma elementu marketingImages. Suma wartości marketingImages i portraitMarketingImages daje maksymalnie 20.

object (AdImageAsset)

Komponenty z pionowym obrazem marketingowym, które zostaną użyte w reklamie. Prawidłowe typy zdjęć to GIF, JPEG i PNG. Minimalny rozmiar to 480 × 600, a współczynnik proporcji 4:5 (+-1%). Suma wartości marketingImages i squareMarketingImages daje maksymalnie 20.

object (AdImageAsset)

Komponenty z obrazem logo do użycia w reklamie. Prawidłowe typy zdjęć to GIF, JPEG i PNG. Minimalny rozmiar to 128 x 128, a współczynnik proporcji: 1:1 (+-1%). Można określić od 1 do 5 obrazów logo.

object (AdTextAsset)

Komponent tekstowy nagłówka reklamy. Maksymalna szerokość wyświetlacza to 30. Możesz określić od 1 do 5 nagłówków.

object (AdTextAsset)

Tekst opisowy reklamy. Maksymalna szerokość wyświetlacza to 90. Możesz określić od 1 do 5 tekstów reklamy.

string

Nazwa reklamodawcy lub marki. Maksymalna szerokość wyświetlacza to 25. To pole jest wymagane.

string

Tekst wezwania do działania.

boolean

Opcja logiczna wskazująca, czy reklama musi być wyświetlana z formularzem kontaktowym.

{
  "businessName": string,
  "logoImage": {
    object (AdImageAsset)
  },
  "headline": {
    object (AdTextAsset)
  },
  "description": {
    object (AdTextAsset)
  },
  "callToActionText": string,
  "carouselCards": [
    {
      object (AdDiscoveryCarouselCardAsset)
    }
  ]
}

string

To pole jest wymagane. Nazwa reklamodawcy lub marki.

object (AdImageAsset)

To pole jest wymagane. Obraz logo do użycia w reklamie. Minimalny rozmiar to 128 x 128, a współczynnik proporcji: 1:1 (+-1%).

object (AdTextAsset)

To pole jest wymagane. Nagłówek reklamy.

object (AdTextAsset)

To pole jest wymagane. Tekst opisowy reklamy.

string

Tekst wezwania do działania.

object (AdDiscoveryCarouselCardAsset)

To pole jest wymagane. Karty karuzeli, które będą się wyświetlać wraz z reklamą. Min. 2 maks. 10

{
  "asset": string
}

string

Nazwa zasobu tej karty karuzeli Discovery.

{
  "headlines": [
    {
      object (AdTextAsset)
    }
  ],
  "longHeadlines": [
    {
      object (AdTextAsset)
    }
  ],
  "descriptions": [
    {
      object (AdTextAsset)
    }
  ],
  "videos": [
    {
      object (AdVideoAsset)
    }
  ],
  "logoImages": [
    {
      object (AdImageAsset)
    }
  ],
  "breadcrumb1": string,
  "breadcrumb2": string,
  "businessName": {
    object (AdTextAsset)
  },
  "callToActions": [
    {
      object (AdCallToActionAsset)
    }
  ]
}

object (AdTextAsset)

Lista komponentów tekstowych używanych w krótkim nagłówku.

object (AdTextAsset)

Lista komponentów tekstowych używanych w długim nagłówku.

object (AdTextAsset)

Lista komponentów tekstowych użytych w tekście reklamy.

object (AdVideoAsset)

Lista komponentów wideo w YouTube użytych w reklamie.

object (AdImageAsset)

Obraz logo do użycia w reklamie. Prawidłowe typy zdjęć to GIF, JPEG i PNG. Minimalny rozmiar to 128 x 128, a współczynnik proporcji: 1:1 (+-1%).

string

Pierwsza część tekstu pojawiającego się w reklamie razem z wyświetlanym adresem URL.

string

Druga część tekstu pojawiająca się w reklamie razem z wyświetlanym adresem URL.

object (AdTextAsset)

To pole jest wymagane. Nazwa reklamodawcy lub marki.

object (AdCallToActionAsset)

Komponenty typu CallToActionAsset, które są używane na potrzeby przycisku „Wezwania do działania”.

{
  "asset": string
}

string

Nazwa zasobu tego zasobu z wezwaniem do działania.