REST Resource: advertisers.adGroupAds

Zasób: AdGroupAd

Pojedyncza reklama powiązana z grupą reklam.

Zapis JSON 
{
  "name": string,
  "advertiserId": string,
  "adGroupAdId": string,
  "adGroupId": string,
  "displayName": string,
  "adPolicy": {
    object (AdPolicy)
  },
  "entityStatus": enum (EntityStatus),
  "adUrls": [
    {
      object (AdUrl)
    }
  ],

  // Union field ad_details can be only one of the following:
  "displayVideoSourceAd": {
    object (DisplayVideoSourceAd)
  },
  "mastheadAd": {
    object (MastheadAd)
  },
  "inStreamAd": {
    object (InStreamAd)
  },
  "nonSkippableAd": {
    object (NonSkippableAd)
  },
  "bumperAd": {
    object (BumperAd)
  },
  "audioAd": {
    object (AudioAd)
  },
  "videoDiscoverAd": {
    object (VideoDiscoveryAd)
  },
  "videoPerformanceAd": {
    object (VideoPerformanceAd)
  }
  // End of list of possible types for union field ad_details.
}
Pola
name

string

Nazwa zasobu reklamy.
advertiserId

string (int64 format)

Unikalny identyfikator reklamodawcy, do którego należy reklama.
adGroupAdId

string (int64 format)

Unikalny identyfikator reklamy. Przypisany przez system.
adGroupId

string (int64 format)

Unikalny identyfikator grupy reklam, do której należy reklama.

.
displayName

string

Wyświetlana nazwa reklamy.

Musi być zakodowany w formacie UTF-8 i mieć maksymalny rozmiar 255 bajtów.
adPolicy

object (AdPolicy)

Stan zatwierdzenia reklamy pod kątem zgodności z zasadami.
entityStatus

enum (EntityStatus)

Stan reklamy.
adUrls[]

object (AdUrl)

Lista adresów URL używanych przez reklamę.

Pole zbiorcze ad_details. Szczegóły reklamy.

ad_details może mieć tylko jedną z tych wartości:
displayVideoSourceAd

object (DisplayVideoSourceAd)

Szczegóły reklamy pochodzącej z kreacji Display & Video 360.
mastheadAd

object (MastheadAd)

Szczegóły reklamy wyświetlanej na stronie głównej YouTube.
inStreamAd

object (InStreamAd)

Szczegóły reklamy In-Stream możliwej do pominięcia po 5 sekundach, która jest używana do osiągania celów marketingowych związanych ze świadomością marki lub zasięgiem.
nonSkippableAd

object (NonSkippableAd)

Szczegóły krótkiej reklamy wideo In-Stream niemożliwej do pominięcia, która trwa od 6 do 15 sekund i jest używana do realizacji celów marketingowych związanych z zasięgiem.
bumperAd

object (BumperAd)

Szczegóły niemożliwej do pominięcia krótkiej reklamy wideo o długości nieprzekraczającej 6 sekund, która jest używana do zwiększania zasięgu.
audioAd

object (AudioAd)

Szczegóły reklamy audio używanej do osiągania celów marketingowych związanych z zasięgiem.
videoDiscoverAd

object (VideoDiscoveryAd)

Szczegóły reklamy promującej film, która wyświetla się w miejscach, w których użytkownicy odkrywają treści.
videoPerformanceAd

object (VideoPerformanceAd)

Szczegóły reklamy używanej w kampanii wideo zachęcającej do działania, która ma zachęcać użytkowników do podejmowania działań związanych z Twoją firmą, usługą lub produktem.

AdPolicy

Jedne zasady dotyczące reklam powiązane z reklamą w grupie reklam.

Zapis JSON 
{
  "adPolicyApprovalStatus": enum (AdPolicyApprovalStatus),
  "adPolicyReviewStatus": enum (AdPolicyReviewStatus),
  "adPolicyTopicEntry": [
    {
      object (AdPolicyTopicEntry)
    }
  ]
}
Pola
adPolicyApprovalStatus

enum (AdPolicyApprovalStatus)

Stan zatwierdzenia reklamy pod kątem zgodności z zasadami, który wskazuje decyzję o zatwierdzeniu.
adPolicyReviewStatus

enum (AdPolicyReviewStatus)

Stan weryfikacji reklamy pod kątem zgodności z zasadami, który wskazuje, na jakim etapie procesu sprawdzania znajduje się obecnie reklama.
adPolicyTopicEntry[]

object (AdPolicyTopicEntry)

Wpisy dotyczące każdego tematu zasad, który został uznany za związany z reklamą. Każdy wpis zawiera temat, poziom ograniczeń i wskazówki dotyczące rozwiązywania problemów ze zgodnością z zasadami.

AdPolicyApprovalStatus

Możliwe stany zatwierdzenia zasad dotyczących reklam.

Wartości w polu enum
AD_POLICY_APPROVAL_STATUS_UNKNOWN Nieznany lub nieokreślony.
DISAPPROVED Nie będą się wyświetlać.
APPROVED_LIMITED Będzie wyświetlana z ograniczeniami.
APPROVED Będzie się wyświetlać bez ograniczeń.
AREA_OF_INTEREST_ONLY Reklama nie będzie się wyświetlać w krajach docelowych, ale może się wyświetlać użytkownikom, którzy szukają informacji o tych krajach.

AdPolicyReviewStatus

Możliwe stany weryfikacji zgodności z zasadami reklamowymi.

Wartości w polu enum
AD_POLICY_REVIEW_STATUS_UNKNOWN Nieznany lub nieokreślony.
REVIEW_IN_PROGRESS Obecnie w trakcie sprawdzania.
REVIEWED Główne sprawdzanie zostało zakończone. Inne opinie mogą być nadal w trakcie sprawdzania.
UNDER_APPEAL Kreacja została ponownie przesłana do zatwierdzenia lub odwołano się od decyzji w sprawie jej zgodności z zasadami.
ELIGIBLE_MAY_SERVE Uznane za kwalifikujące się i mogą się wyświetlać. Może być konieczne dalsze sprawdzenie.

AdPolicyTopicEntry

Wpis opisujący, w jaki sposób reklama została uznana za powiązaną z zasadami reklamowymi.

Zapis JSON 
{
  "policyTopic": string,
  "policyLabel": string,
  "policyTopicDescription": string,
  "policyTopicType": enum (AdPolicyTopicEntryType),
  "policyDecisionType": enum (AdPolicyDecisionType),
  "policyEnforcementMeans": enum (AdPolicyEnforcementMeans),
  "policyTopicEvidences": [
    {
      object (AdPolicyTopicEvidence)
    }
  ],
  "policyTopicConstraints": [
    {
      object (AdPolicyTopicConstraint)
    }
  ],
  "helpCenterLink": string,
  "appealInfo": {
    object (AdPolicyTopicAppealInfo)
  }
}
Pola
policyTopic

string

Temat zasad.

Przykłady: „TRADEMARKS”, „ALCOHOL” itp.
policyLabel

string

Zlokalizowany tekst etykiety zasad.

Przykłady to „Znaki towarowe w tekście”, „Zawiera alkohol” itp.
policyTopicDescription

string

Krótki opis tematu zasady.
policyTopicType

enum (AdPolicyTopicEntryType)

Jak wyświetlanie reklam będzie wpływać na temat zasad reklamowych.
policyDecisionType

enum (AdPolicyDecisionType)

Źródło decyzji dotyczącej zasad.
policyEnforcementMeans

enum (AdPolicyEnforcementMeans)

Środek egzekwowania zasad użyty podczas sprawdzania zgodności z zasadami.
policyTopicEvidences[]

object (AdPolicyTopicEvidence)

Dowody użyte w decyzji dotyczącej zasad.
policyTopicConstraints[]

object (AdPolicyTopicConstraint)

Ograniczenia wyświetlania związane z decyzją dotyczącą zasad.
appealInfo

object (AdPolicyTopicAppealInfo)

Informacje o tym, jak odwołać się od decyzji dotyczącej zgodności z zasadami.

AdPolicyTopicEntryType

Możliwy wpływ tematu zasad dotyczących reklam na wyświetlanie reklam.

Wartości w polu enum
AD_POLICY_TOPIC_ENTRY_TYPE_UNKNOWN Nieznany lub nieokreślony.
PROHIBITED Zasób nie będzie się wyświetlać.
FULLY_LIMITED Zasób nie będzie się wyświetlać we wszystkich krajach docelowych.
LIMITED Zasób nie może się wyświetlać w niektórych krajach.
DESCRIPTIVE Zasób może być wyświetlany.
BROADENING Zasób może być wyświetlany i może być wyświetlany poza normalnym zasięgiem.
AREA_OF_INTEREST_ONLY Zasób jest ograniczony we wszystkich krajach docelowych, ale może być wyświetlany użytkownikom, którzy szukają informacji o tych krajach.

AdPolicyDecisionType

Możliwe źródła decyzji dotyczącej zasad.

Wartości w polu enum
AD_POLICY_DECISION_TYPE_UNKNOWN Nieznany lub nieokreślony.
PURSUANT_TO_NOTICE Decyzja wynika z powiadomienia prawnego, orzeczenia sądowego, skargi właściciela znaku towarowego itp.
GOOGLE_INVESTIGATION Decyzja została podjęta w wyniku dochodzenia przeprowadzonego przez Google.

AdPolicyEnforcementMeans

Możliwe środki egzekwowania zasad użyte podczas sprawdzania zgodności z zasadami.

Wartości w polu enum
AD_POLICY_ENFORCEMENT_MEANS_UNKNOWN Nieznany lub nieokreślony.
AUTOMATED Proces egzekwowania był w pełni zautomatyzowany.
HUMAN_REVIEW W procesie egzekwowania decyzji brał udział człowiek (częściowo lub w pełni).

AdPolicyTopicEvidence

Informacje o dowodach użyte w decyzji dotyczącej zasad.

Zapis JSON 
{

  // Union field value can be only one of the following:
  "textList": {
    object (TextList)
  },
  "websiteList": {
    object (WebsiteList)
  },
  "httpCode": integer,
  "languageCode": string,
  "destinationTextList": {
    object (DestinationTextList)
  },
  "destinationMismatch": {
    object (DestinationMismatch)
  },
  "destinationNotWorking": {
    object (DestinationNotWorking)
  },
  "trademark": {
    object (Trademark)
  },
  "legalRemoval": {
    object (LegalRemoval)
  },
  "counterfeit": {
    object (Counterfeit)
  },
  "regionalRequirements": {
    object (RegionalRequirements)
  }
  // End of list of possible types for union field value.
}
Pola
Pole zbiorcze value. Dowody potwierdzające decyzję dotyczącą zasad. value może mieć tylko jedną z tych wartości:
textList

object (TextList)

Lista dowodów znalezionych w tekście reklamy.
websiteList

object (WebsiteList)

Lista witryn powiązanych z reklamą.
httpCode

integer

Kod HTTP zwrócony podczas skanowania końcowego adresu URL.
languageCode

string

Język, w którym została napisana reklama.

W tym polu używane są tagi języka IETF, np. „en-US”.
destinationTextList

object (DestinationTextList)

Tekst w miejscu docelowym reklamy, który powoduje naruszenie zasad.
destinationMismatch

object (DestinationMismatch)

Niezgodność adresów URL miejsc docelowych reklamy.
destinationNotWorking

object (DestinationNotWorking)

Informacje o błędach HTTP lub DNS związanych z miejscem docelowym reklamy.
trademark

object (Trademark)

Terminy związane ze znakami towarowymi, które spowodowały naruszenie zasad.
legalRemoval

object (LegalRemoval)

Egzekwowanie przepisów prawnych, które spowodowało naruszenie zasad.
counterfeit

object (Counterfeit)

egzekwowanie zasad dotyczących podróbek, które spowodowało naruszenie zasad;
regionalRequirements

object (RegionalRequirements)

Proaktywne egzekwowanie zasad przez zespół ds. zaufania i bezpieczeństwa, które spowodowało naruszenie zasad.

TextList

Lista fragmentów tekstu, które naruszają zasady.

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

string

Fragmenty tekstu z zasobu, które spowodowały wykrycie naruszenia zasad.

WebsiteList

Lista witryn, które naruszyły zasady.

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

string

Witryny, które spowodowały wykrycie naruszenia zasad.

DestinationTextList

Lista tekstów docelowych, które naruszają zasady.

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

string

Tekst strony docelowej, który spowodował wykrycie naruszenia zasad.

DestinationMismatch

Szczegóły dotyczące niezgodności między typami docelowych adresów URL.

Zapis JSON 
{
  "uriTypes": [
    enum (AdPolicyTopicEvidenceDestinationMismatchUrlType)
  ]
}
Pola
uriTypes[]

enum (AdPolicyTopicEvidenceDestinationMismatchUrlType)

Zestaw adresów URL, które nie pasują. Lista może zawierać jeden lub więcej typów URI.

Przykład 1: [DISPLAY_URL, FINAL_URL] oznacza, że wyświetlany adres URL reklamy nie jest zgodny z końcowym adresem URL reklamy.

Przykład 2: [FINAL_URL] oznacza, że końcowy adres URL reklamy nie jest zgodny z adresem URL zindeksowanym przez wyszukiwarkę, co również jest uznawane za niezgodność miejsca docelowego.

AdPolicyTopicEvidenceDestinationMismatchUrlType

Możliwe typy adresów URL.

Wartości w polu enum
AD_POLICY_TOPIC_EVIDENCE_DESTINATION_MISMATCH_URL_TYPE_UNKNOWN Nieokreślony lub nieznany.
DISPLAY_URL Wyświetlany URL.
FINAL_URL Końcowy URL
FINAL_MOBILE_URL Końcowy mobilny adres URL.
TRACKING_URL Link monitorujący.
MOBILE_TRACKING_URL Link monitorujący na urządzenia mobilne.

DestinationNotWorking

Szczegóły błędów HTTP lub DNS związanych z miejscem docelowym reklamy.

Zapis JSON 
{
  "expandedUri": string,
  "device": enum (AdPolicyTopicEvidenceDestinationNotWorkingDeviceType),
  "lastCheckedTime": string,

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

string

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

enum (AdPolicyTopicEvidenceDestinationNotWorkingDeviceType)

Urządzenie, na którym odwiedzenie adresu URL spowodowało błąd.
lastCheckedTime

string (Timestamp format)

Ostatni raz, gdy błąd wystąpił podczas przechodzenia do adresu URL.

Korzysta ze standardu RFC 3339, w którym wygenerowane dane wyjściowe są zawsze znormalizowane do formatu Z i zawierają 0, 3, 6 lub 9 cyfr po przecinku. Akceptowane są też przesunięcia inne niż „Z”. Przykłady: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" lub "2014-10-02T15:01:23+05:30".
Pole zbiorcze reason. Błąd HTTP lub DNS. reason może mieć tylko jedną z tych wartości:
dnsErrorType

enum (AdPolicyTopicEvidenceDestinationNotWorkingDnsErrorType)

Rodzaj błędu DNS.
httpErrorCode

string (int64 format)

Kod błędu HTTP.

AdPolicyTopicEvidenceDestinationNotWorkingDnsErrorType

Możliwe typy błędów DNS.

Wartości w polu enum
AD_POLICY_TOPIC_EVIDENCE_DESTINATION_NOT_WORKING_DNS_ERROR_TYPE_UNKNOWN Nieokreślony lub nieznany.
HOSTNAME_NOT_FOUND Podczas pobierania strony docelowej nie znaleziono nazwy hosta w DNS.
GOOGLE_CRAWLER_DNS_ISSUE Nie udało się zindeksować strony docelowej podczas komunikacji z serwerem DNS.

AdPolicyTopicEvidenceDestinationNotWorkingDeviceType

Urządzenia, na których podczas odwiedzania adresu URL wystąpił błąd.

Wartości w polu enum
AD_POLICY_TOPIC_EVIDENCE_DESTINATION_NOT_WORKING_DEVICE_TYPE_UNKNOWN Nieokreślony lub nieznany.
DESKTOP komputer,
ANDROID urządzenie z Androidem;
IOS urządzenie z iOS;

Znak towarowy

Terminy związane ze znakami towarowymi, które spowodowały naruszenie zasad.

Zapis JSON 
{
  "owner": string,
  "term": string,
  "countryRestrictions": [
    {
      object (AdPolicyCriterionRestriction)
    }
  ]
}
Pola
owner

string

Właściciel treści zawierających znak towarowy.
term

string

Hasło będące znakiem towarowym.
countryRestrictions[]

object (AdPolicyCriterionRestriction)

Kraje, w których naruszenie zasad jest istotne.

AdPolicyCriterionRestriction

Reprezentuje ograniczenie dotyczące kraju.

Zapis JSON 
{
  "countryCriterionId": string,
  "countryLabel": string
}
Pola
countryCriterionId

string (int64 format)

Identyfikator kryterium kraju.
countryLabel

string

Zlokalizowana nazwa kraju. Może być puste.

LegalRemoval

egzekwowanie przepisów prawnych, w tym ustawy DMCA i lokalnych przepisów prawnych;

Zapis JSON 
{
  "complaintType": enum (AdPolicyTopicEvidenceLegalRemovalComplaintType),
  "countryRestrictions": [
    {
      object (AdPolicyCriterionRestriction)
    }
  ],
  "restrictedUris": [
    string
  ],

  // Union field type can be only one of the following:
  "dmca": {
    object (Dmca)
  },
  "localLegal": {
    object (LocalLegal)
  }
  // End of list of possible types for union field type.
}
Pola
complaintType

enum (AdPolicyTopicEvidenceLegalRemovalComplaintType)

rodzaj skargi, która spowodowała usunięcie treści ze względów prawnych;
countryRestrictions[]

object (AdPolicyCriterionRestriction)

Kraje, w których dostęp został ograniczony z powodu usunięcia treści na podstawie przepisów prawa.
restrictedUris[]

string

Adresy URL, które zostały objęte ograniczeniami z powodu usunięcia treści na podstawie przepisów prawa.
Pole zbiorcze type. Szczegóły dotyczące typu usunięcia z przyczyn prawnych. type może mieć tylko jedną z tych wartości:
dmca

object (Dmca)

Szczegółowe informacje o usuwaniu treści na podstawie ustawy DMCA.

Ustawa DMCA

Szczegóły skargi związanej z ustawą DMCA.

Zapis JSON 
{
  "complainant": string
}
Pola
complainant

string

Podmiot, który złożył skargę prawną.

LocalLegal

Szczegóły lokalnych przepisów prawnych.

Zapis JSON 
{
  "lawType": string
}
Pola
lawType

string

Rodzaj prawa, którego dotyczy informacja prawna.

AdPolicyTopicEvidenceLegalRemovalComplaintType

Możliwe typy skarg w przypadku usunięcia treści ze względów prawnych.

Wartości w polu enum
COPYRIGHT

Prawa autorskie.

Dotyczy tylko ustawy DMCA.
COURT_ORDER

orzeczenie sądowe,

Dotyczy tylko lokalnych przepisów prawnych.

Podróbki

Szczegóły dotyczące egzekwowania zasad dotyczących podróbek, które spowodowało naruszenie zasad.

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

string

Właściciele treści lub produktów, którzy złożyli skargę.

RegionalRequirements

Proaktywne egzekwowanie zasad dotyczących zaufania i bezpieczeństwa, które mają na celu spełnienie wymagań regionalnych. Jest to dochodzenie prowadzone przez Google, a nie powiadomienie o przepisach, ponieważ jest to proaktywne egzekwowanie zasad.

Zapis JSON 
{
  "regionalRequirementsEntries": [
    {
      object (RegionalRequirementsEntry)
    }
  ]
}
Pola
regionalRequirementsEntries[]

object (RegionalRequirementsEntry)

Lista wymagań regionalnych.

RegionalRequirementsEntry

Szczegóły naruszenia przepisów regionalnych na poziomie zasad.

Zapis JSON 
{
  "legalPolicy": string,
  "countryRestrictions": [
    {
      object (AdPolicyCriterionRestriction)
    }
  ]
}
Pola
legalPolicy

string

zasady prawne, które są naruszane;
countryRestrictions[]

object (AdPolicyCriterionRestriction)

Kraje, w których obowiązują ograniczenia z powodu zasad prawnych.

AdPolicyTopicConstraint

Szczegóły dotyczące ograniczeń wyświetlania reklam.

Zapis JSON 
{
  "requestCertificateFormLink": string,

  // Union field constraint can be only one of the following:
  "countryConstraint": {
    object (AdPolicyCountryConstraintList)
  },
  "resellerConstraint": {
    object (AdPolicyResellerConstraint)
  },
  "certificateMissingCountryList": {
    object (AdPolicyCountryConstraintList)
  },
  "certificateDomainMismatchCountryList": {
    object (AdPolicyCountryConstraintList)
  },
  "globalCertificateMissing": {
    object (AdPolicyGlobalCertificateMissingConstraint)
  },
  "globalCertificateDomainMismatch": {
    object (AdPolicyGlobalCertificateDomainMismatchConstraint)
  }
  // End of list of possible types for union field constraint.
}
Pola
Pole zbiorcze constraint. Ograniczenie wyświetlania. constraint może mieć tylko jedną z tych wartości:
countryConstraint

object (AdPolicyCountryConstraintList)

Kraje, w których reklama nie może się wyświetlać.
resellerConstraint

object (AdPolicyResellerConstraint)

Ograniczenie sprzedawcy.
certificateMissingCountryList

object (AdPolicyCountryConstraintList)

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

object (AdPolicyCountryConstraintList)

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

object (AdPolicyGlobalCertificateMissingConstraint)

Certyfikat jest wymagany, aby reklama mogła się wyświetlać w dowolnym kraju.
globalCertificateDomainMismatch

object (AdPolicyGlobalCertificateDomainMismatchConstraint)

Certyfikat jest wymagany do wyświetlania reklam w dowolnym kraju, a obecny certyfikat nie obejmuje domeny reklamy.

AdPolicyCountryConstraintList

Lista krajów, w których reklama nie może się wyświetlać z powodu ograniczeń wynikających z zasad.

Zapis JSON 
{
  "countries": [
    {
      object (AdPolicyCriterionRestriction)
    }
  ]
}
Pola
countries[]

object (AdPolicyCriterionRestriction)

Kraje, w których reklama nie może się wyświetlać.

AdPolicyResellerConstraint

Ten typ nie ma pól.

Temat zasad został ograniczony z powodu odrzucenia witryny do celów odsprzedaży.

AdPolicyGlobalCertificateMissingConstraint

Ten typ nie ma pól.

Certyfikat jest wymagany, aby reklama mogła się wyświetlać w dowolnym kraju.

AdPolicyGlobalCertificateDomainMismatchConstraint

Ten typ nie ma pól.

Certyfikat jest wymagany do wyświetlania reklam w dowolnym kraju, a obecny certyfikat nie obejmuje domeny reklamy.

AdPolicyTopicAppealInfo

Informacje o tym, jak odwołać się od decyzji dotyczącej zgodności z zasadami.

Zapis JSON 
{
  "appealType": enum (AdPolicyAppealType),
  "appealFormLink": string
}
Pola
appealType

enum (AdPolicyAppealType)

Czy od decyzji można się odwołać za pomocą formularza odwołania lub w ramach samoobsługowego procesu odwoławczego.

AdPolicyAppealType

Możliwe typy odwołań.

Wartości w polu enum
AD_POLICY_APPEAL_TYPE_UNKNOWN Nieznany lub nieokreślony.
SELF_SERVICE_APPEAL Od decyzji można się odwołać w ramach samoobsługowego procesu odwoławczego.
APPEAL_FORM Od decyzji można się odwołać za pomocą formularza odwołania.

DisplayVideoSourceAd

Reklama pochodzi z kreacji DV360.

Zapis JSON 
{
  "creativeId": string
}
Pola
creativeId

string (int64 format)

Identyfikator kreacji źródłowej.

MastheadAd

Szczegóły reklamy w banerze masthead.

Zapis JSON 
{
  "video": {
    object (YoutubeVideoDetails)
  },
  "headline": string,
  "description": string,
  "videoAspectRatio": enum (VideoAspectRatio),
  "autoplayVideoStartMillisecond": string,
  "autoplayVideoDuration": string,
  "callToActionButtonLabel": string,
  "callToActionFinalUrl": string,
  "callToActionTrackingUrl": string,
  "showChannelArt": boolean,
  "companionYoutubeVideos": [
    {
      object (YoutubeVideoDetails)
    }
  ]
}
Pola
video

object (YoutubeVideoDetails)

Film w YouTube używany przez reklamę.
headline

string

Nagłówek reklamy.
description

string

Opis reklamy.
videoAspectRatio

enum (VideoAspectRatio)

Współczynnik proporcji automatycznie odtwarzanego filmu w YouTube w mastheadzie.
autoplayVideoStartMillisecond

string (int64 format)

Czas w milisekundach, po którym rozpocznie się odtwarzanie filmu.
autoplayVideoDuration

string (Duration format)

Czas, przez jaki film będzie odtwarzany automatycznie.

Czas trwania w sekundach z maksymalnie 9 miejscami po przecinku, zakończony znakiem „s”. Przykład: "3.5s".
callToActionButtonLabel

string

Tekst na przycisku z wezwaniem do działania.
callToActionFinalUrl

string

Docelowy adres URL przycisku z wezwaniem do działania.
callToActionTrackingUrl

string

Adres URL śledzenia przycisku wezwania do działania.
showChannelArt

boolean

Określa, czy ma być wyświetlane tło lub baner u góry strony w YouTube.
companionYoutubeVideos[]

object (YoutubeVideoDetails)

Filmy wyświetlane obok reklamy w banerze masthead na komputerach. Maksymalnie 2.

YoutubeVideoDetails

Szczegóły filmu w YouTube.

Zapis JSON 
{
  "id": string,
  "unavailableReason": enum (VideoUnavailableReason)
}
Pola
id

string

Identyfikator filmu w YouTube, który można wyszukać na stronie YouTube.
unavailableReason

enum (VideoUnavailableReason)

Przyczyna niedostępności danych o filmie.

VideoUnavailableReason

Możliwe przyczyny niedostępności filmu.

Wartości w polu enum
VIDEO_UNAVAILABLE_REASON_UNSPECIFIED Nieznane lub nieokreślone.
VIDEO_UNAVAILABLE_REASON_PRIVATE Ten film wideo jest prywatny.
VIDEO_UNAVAILABLE_REASON_DELETED Film zostanie usunięty.

VideoAspectRatio

Możliwe formaty obrazu filmu w YouTube.

Wartości w polu enum
VIDEO_ASPECT_RATIO_UNSPECIFIED Nieokreślony lub nieznany.
VIDEO_ASPECT_RATIO_WIDESCREEN Film jest rozciągnięty, a jego górna i dolna część są przycięte.
VIDEO_ASPECT_RATIO_FIXED_16_9 Film ma stały format obrazu 16:9.

InStreamAd

Szczegóły reklamy In-Stream.

Zapis JSON 
{
  "commonInStreamAttribute": {
    object (CommonInStreamAttribute)
  },
  "customParameters": {
    string: string,
    ...
  }
}
Pola
commonInStreamAttribute

object (CommonInStreamAttribute)

Typowe atrybuty reklamy.
customParameters

map (key: string, value: string)

Parametry niestandardowe do przekazywania wartości niestandardowych do szablonu linku monitorującego.

Obiekt zawierający listę par "key": value. Przykład: { "name": "wrench", "mass": "1.3kg", "count": "3" }

CommonInStreamAttribute

Wspólne atrybuty reklam In-Stream, reklam niemożliwych do pominięcia i bumperów reklamowych.

Zapis JSON 
{
  "displayUrl": string,
  "finalUrl": string,
  "trackingUrl": string,
  "actionButtonLabel": string,
  "actionHeadline": string,
  "video": {
    object (YoutubeVideoDetails)
  },
  "companionBanner": {
    object (ImageAsset)
  }
}
Pola
displayUrl

string

Adres strony internetowej widoczny w reklamie.
finalUrl

string

Adres URL strony, na którą użytkownik trafia po kliknięciu reklamy.
trackingUrl

string

Adres URL ładowany w tle na potrzeby śledzenia.
actionButtonLabel

string

Tekst na przycisku z wezwaniem do działania.
actionHeadline

string

Nagłówek banera z wezwaniem do działania.
video

object (YoutubeVideoDetails)

Film w YouTube, który jest reklamą.
companionBanner

object (ImageAsset)

Obraz wyświetlany obok reklamy wideo.

ImageAsset

Metadane komponentu z obrazem.

Zapis JSON 
{
  "mimeType": string,
  "fullSize": {
    object (Dimensions)
  },
  "fileSize": string
}
Pola
mimeType

string

Typ MIME komponentu z obrazem.
fullSize

object (Dimensions)

Metadane tego obrazu w oryginalnym rozmiarze.
fileSize

string (int64 format)

Rozmiar pliku komponentu z obrazem w bajtach.

NonSkippableAd

Szczegóły reklamy niemożliwej do pominięcia.

Zapis JSON 
{
  "commonInStreamAttribute": {
    object (CommonInStreamAttribute)
  },
  "customParameters": {
    string: string,
    ...
  }
}
Pola
commonInStreamAttribute

object (CommonInStreamAttribute)

Typowe atrybuty reklamy.
customParameters

map (key: string, value: string)

Parametry niestandardowe do przekazywania wartości niestandardowych do szablonu linku monitorującego.

Obiekt zawierający listę par "key": value. Przykład: { "name": "wrench", "mass": "1.3kg", "count": "3" }

BumperAd

Szczegóły bumpera reklamowego.

Zapis JSON 
{
  "commonInStreamAttribute": {
    object (CommonInStreamAttribute)
  }
}
Pola
commonInStreamAttribute

object (CommonInStreamAttribute)

Typowe atrybuty reklamy.

AudioAd

Szczegóły reklamy audio.

Zapis JSON 
{
  "displayUrl": string,
  "finalUrl": string,
  "trackingUrl": string,
  "video": {
    object (YoutubeVideoDetails)
  }
}
Pola
displayUrl

string

Adres strony internetowej widoczny w reklamie.
finalUrl

string

Adres URL strony, na którą użytkownik trafia po kliknięciu reklamy.
trackingUrl

string

Adres URL ładowany w tle na potrzeby śledzenia.
video

object (YoutubeVideoDetails)

Film w YouTube, który jest reklamą.

VideoDiscoveryAd

Szczegóły reklamy wideo Discovery.

Zapis JSON 
{
  "headline": string,
  "description1": string,
  "description2": string,
  "video": {
    object (YoutubeVideoDetails)
  },
  "thumbnail": enum (Thumbnail)
}
Pola
headline

string

Nagłówek reklamy.
description1

string

Pierwszy wiersz tekstu reklamy.
description2

string

Druga linia tekstu reklamy.
video

object (YoutubeVideoDetails)

Film w YouTube, który jest promowany przez reklamę.
thumbnail

enum (Thumbnail)

Miniatura używana w reklamie.

Miniatura

Możliwe opcje miniatur w reklamach wideo Discovery.

Wartości w polu enum
THUMBNAIL_UNSPECIFIED Nieznane lub nieokreślone.
THUMBNAIL_DEFAULT Domyślna miniatura może być wygenerowana automatycznie lub przesłana przez użytkownika.
THUMBNAIL_1 Miniatura 1 wygenerowana z filmu.
THUMBNAIL_2 Miniatura 2 wygenerowana na podstawie filmu.
THUMBNAIL_3 Miniatura 3 wygenerowana z filmu.

VideoPerformanceAd

Szczegóły reklamy wideo zachęcającej do działania.

Zapis JSON 
{
  "finalUrl": string,
  "trackingUrl": string,
  "actionButtonLabels": [
    string
  ],
  "headlines": [
    string
  ],
  "longHeadlines": [
    string
  ],
  "descriptions": [
    string
  ],
  "displayUrlBreadcrumb1": string,
  "displayUrlBreadcrumb2": string,
  "domain": string,
  "videos": [
    {
      object (YoutubeVideoDetails)
    }
  ],
  "customParameters": {
    string: string,
    ...
  },
  "companionBanners": [
    {
      object (ImageAsset)
    }
  ]
}
Pola
finalUrl

string

Adres URL strony, na którą użytkownik trafia po kliknięciu reklamy.
trackingUrl

string

Adres URL ładowany w tle na potrzeby śledzenia.
actionButtonLabels[]

string

Lista komponentów tekstowych wyświetlanych na przycisku z wezwaniem do działania.
headlines[]

string

Lista nagłówków wyświetlanych na banerze wezwania do działania.
longHeadlines[]

string

Lista samodzielnych nagłówków wyświetlanych na banerze wezwania do działania.
descriptions[]

string

Lista opisów wyświetlanych na banerze wezwania do działania.
displayUrlBreadcrumb1

string

Pierwsza część wyświetlanego adresu URL po domenie.
displayUrlBreadcrumb2

string

Drugi element po domenie w wyświetlanym adresie URL.
domain

string

Domena wyświetlanego adresu URL.
videos[]

object (YoutubeVideoDetails)

Lista komponentów z filmem w YouTube używanych przez tę reklamę.
customParameters

map (key: string, value: string)

Parametry niestandardowe do przekazywania wartości niestandardowych do szablonu linku monitorującego.

Obiekt zawierający listę par "key": value. Przykład: { "name": "wrench", "mass": "1.3kg", "count": "3" }
companionBanners[]

object (ImageAsset)

Lista banerów towarzyszących używanych przez tę reklamę.

AdUrl

Dodatkowe adresy URL powiązane z reklamą, w tym sygnały.

Zapis JSON 
{
  "type": enum (AdUrlType),
  "url": string
}
Pola
type

enum (AdUrlType)

Typ adresu URL reklamy.
url

string

Wartość ciągu URL.

AdUrlType

Możliwe typy adresów URL reklamy.

Wartości w polu enum
AD_URL_TYPE_UNSPECIFIED Nieznane lub nieokreślone.
AD_URL_TYPE_BEACON_IMPRESSION Piksel śledzący 1 x 1, który wysyła sygnał ping, gdy wyświetlenie kreacji zostanie zrealizowane.
AD_URL_TYPE_BEACON_EXPANDABLE_DCM_IMPRESSION Śledzenie wyświetleń (beacon) rozwijanej reklamy DCM. W momencie wyświetlania reklamy jest ona rozwijana do kilku sygnałów.
AD_URL_TYPE_BEACON_CLICK Link monitorujący, który należy wysłać pingiem po aktywowaniu zdarzenia kliknięcia.
AD_URL_TYPE_BEACON_SKIP Adres URL śledzenia, który należy pingować po wywołaniu zdarzenia pominięcia.

Metody

get

 Pobiera reklamę w grupie reklam.

list

 Wyświetla reklamy w grupie reklam.