Czy chcesz podzielić się opinią na temat interfejsu Google Ads API? Zarejestruj się, aby otrzymać zaproszenie do udziału w badaniach opinii użytkowników.

Ta strona została przetłumaczona przez Cloud Translation API.

Informacje o wersjach

v19 (26.02.2025)

W wersji 19 dodano te funkcje i zmiany:

Zarządzanie kontem

Aby uwzględnić nadchodzące zmiany, do CustomerError dodaliśmy te wartości:
- CREATION_DENIED_FOR_POLICY_VIOLATION
- CREATION_DENIED_INELIGIBLE_MCC

Reklamy

Dodano komponent DemandGenMultiAssetAdInfo.tall_portrait_marketing_images, aby umożliwić obsługę komponentów z obrazem pionowym o stosunku proporcji 9:16 w reklamach generujących popyt.

Zasoby

(Dotyczy tylko kont na białej liście) Dodano obsługę komponentów wiadomości za pomocą Asset.business_message_asset i następujących enumeracji oraz błędów:
- Wykazy:
- Błędy:
  - AssetError.CUSTOMER_NOT_ON_ALLOWLIST_FOR_WHATSAPP_MESSAGE_ASSETS
  - ResourceLimitType
Dodano AssetAutomationType.GENERATE_LANDING_PAGE_PREVIEW, aby umożliwić automatyczne generowanie podglądu strony docelowej.
AssetAutomationType.GENERATE_SHORTER_YOUTUBE_VIDEOS jest teraz domyślnie włączona w przypadku responsywnych reklam wideo generujących popyt.
(Tylko dla kont na liście dozwolonych; lista dozwolonych jest obecnie zamknięta) Dodano Asset.app_deep_link_asset i AppDeepLinkAsset.

Konwersje

Cele konwersji
- Właściwość LifecycleGoalValueSettings.high_lifetime_value nie jest już w wersji beta i można ją modyfikować.
- Dodaliśmy CustomerLifecycleGoal.owner_customer, aby wyświetlać nazwę zasobu klienta, do którego należy cel cyklu życia klienta.
Wycofano: ConversionActionType.SALESFORCE.

Pliki danych

Usunięto wszystkie elementy związane z kanałem, takie jak Feed, FeedMapping, FeedService, AdGroupFeed, feed_placeholder_view itp. Użytkownicy powinni teraz używać zasobów do osiągnięcia tego samego celu. Listę wszystkich usuniętych elementów znajdziesz w notatkach dotyczących migracji.

Hotele i podróże

Zmiana pól min_days i max_days w ValueRuleItineraryAdvanceBookingWindow na pola optional, aby umożliwić podanie wartości 0. Umożliwia to kierowanie na wyszukiwania dotyczące podróży, które mają miejsce dzisiaj.

Performance Max

(Dotyczy tylko kont na liście dozwolonych) Wytyczne dotyczące marki
- Ustawienie Campaign.brand_guidelines_enabledstało się możliwe do zmiany tylko podczas tworzenia kampanii Performance Max.
- Ta funkcja jest niezgodna z kampaniami Performance Max do celów związanych z podróżami.
- Aby włączyć wskazówki dotyczące marki w dotychczasowych kampaniach Performance Max, użyj nowo dodanego CampaignService.EnablePMaxBrandGuidelines. Wyłączenie wskazówek dotyczących marki nie jest obsługiwane.
- Dodano Campaign.brand_guidelines i BrandGuidelines, aby umożliwić ustawienie kolorów i rodziny czcionek marki.
- Nowe wartości błędów:
  - BatchJobError.CAMPAIGN_AND_CAMPAIGN_ASSET_TRANSACTION_FAILURE
  - BrandGuidelinesMigrationError
- CampaignError
  - BRAND_GUIDELINES_NOT_ENABLED_FOR_CAMPAIGN
  - BRAND_GUIDELINES_MAIN_AND_ACCENT_COLORS_REQUIRED
  - BRAND_GUIDELINES_COLOR_INVALID_FORMAT
  - BRAND_GUIDELINES_UNSUPPORTED_FONT_FAMILY
  - BRAND_GUIDELINES_UNSUPPORTED_CHANNEL
  - CANNOT_ENABLE_BRAND_GUIDELINES_FOR_TRAVEL_GOALS
  - CUSTOMER_NOT_ALLOWLISTED_FOR_BRAND_GUIDELINES
Dodaliśmy AssetAutomationType.GENERATE_ENHANCED_YOUTUBE_VIDEOS, aby umożliwić automatyczne generowanie ulepszonych komponentów wideo w kampaniach Performance Max.

Planowanie

(Tylko w przypadku kont na liście dozwolonych) Dodano ContentCreatorInsightsService.GenerateTrendingInsights, która pozwala użytkownikom wyświetlać w YouTube tematy treści na topie dla określonych definicji odbiorców.
Dodano GenerateCreatorInsightsRequest.country_locations[], aby można było określić kraje, w których mają być wyszukiwane dane kryteria.
Dodano GenerateCreatorInsightsRequest.search_brand, aby umożliwić wyszukiwanie twórców według marki.
Dodaliśmy nowe pola do zapytania YouTubeChannelInsights, aby zapewnić dodatkowe informacje o kanale w żądaniach search_channels:
- channel_url
- channel_description
- top_videos
Dodaliśmy nowe pola metadanych do AudienceInsightsAttributeMetadata:
- youtube_video_metadata
- user_interest_attribute_metadata
- knowledge_graph_attribute_metadata

Filmy

Po wydaniu wersji DataLinkService.CreateDataLink dodaliśmy te metody, aby umożliwić modyfikowanie wcześniej utworzonych połączeń danych:
- RemoveDataLink informacje o usuwaniu połączeń danych na koncie Google Ads
- UpdateDataLink – do akceptowania, odrzucania i odwoływania połączeń danych na koncie Google Ads.
Usunięto obsługę wartości VIDEO_OUTSTREAM z tych typów enumeracji:

v18 (16.10.2024)

W wersji 18 dodaliśmy te nowe funkcje i aktualizacje.

Zarządzanie kontem

(Tylko w przypadku kont na białej liście) Dodano DataLinkService.CreateDataLink, który umożliwia połączenie konta Google Ads z filmami twórców hostowanymi na ich kanale w YouTube. Połączenie filmu umożliwia kontu Google Ads wyświetlanie reklam partnerskich z użyciem filmów twórców.

Grupy reklam

Dodano AdGroup.exclude_demographic_expansion, która umożliwia wykluczenie danych demograficznych z rozwiniętego raportu, gdy optimized_targeting_enabled jest true. Ta funkcja była wcześniej obsługiwana tylko w przypadku kampanii generujących popyt.

Reklamy

Dodano AdGroupAd.ad_group_ad_asset_automation_settings, co umożliwia włączanie i wyłączanie automatycznego generowania komponentów reklamy.
Do wartości AssetAutomationType dodaliśmy te wartości:
- GENERATE_VERTICAL_YOUTUBE_VIDEOS
- GENERATE_SHORTER_YOUTUBE_VIDEOS
Dodano AdNetworkType.GOOGLE_OWNED_CHANNELS, które jest używane przez reklamy wyświetlane w kanałach należących do Google, takich jak YouTube, Gmail i karty Discover.

Zasoby

Nazwa AssetType.DISCOVERY_CAROUSEL_CARD została zmieniona na AssetType.DEMAND_GEN_CAROUSEL_CARD.

Kampanie

Dodano kolumnę metrics.store_visits_last_click_model_attributed_conversions, która zwraca liczbę wizyt w sklepie stacjonarnym przypisanych do kampanii na podstawie modelu atrybucji ostatniego kliknięcia.
Dodaliśmy do kampanii te dane dotyczące wyświetleń filmów:
Dodano kolumnę metrics.results_conversions_purchase, która zwraca zakupy w ramach konwersji w ujednoliconych wynikach celów kampanii.
Zmieniono domyślną wartość parametru DemandGenCampaignSettings.upgraded_targeting z false na true.

Kryterium

Dodano kolumnę content_criterion_view, która zwraca dane o wydajności docelonych treści, np. słów kluczowych, miejsc docelowych i tematów, w przypadku kampanii w sieci reklamowej, kampanii generujących popyt i kampanii wideo.

Hotele i podróże

Obsługa plików danych o podróżach w reklamach w wyszukiwarce
- Dodano ClickType.TRAVEL_ASSETS, aby umożliwić podział danych plików danych o miejscach noclegowych w reklamach w wyszukiwarce na segmenty.
- Dodano opcję AssetSetType.TRAVEL_FEED, która umożliwia wyrażenie zgody na korzystanie z pliku danych o podróżach w reklamach w wyszukiwarce lub rezygnację z tego rozwiązania.
(Dotyczy tylko kont na białej liście) Dodano plan podróży jako nową regułę wartości konwersji z tymi nowymi polami i wartościami:
- ConversionValueRule.itinerary_condition z ValueRuleItineraryCondition, która umożliwia określenie okresu rezerwacji z wyprzedzeniem, długości planu podróży i dni tygodnia rozpoczęcia podróży.
- ConversionValueRulePrimaryDimensionEnum.ITINERARY
- ValueRuleSetDimension.ITINERARY
Do raportów campaign i ad_group dodaliśmy te segmenty, aby umożliwić dzielenie danych o skuteczności na podstawie konkretnych miejsc docelowych (miast, krajów i regionów) w przypadku kampanii reklam hoteli i kampanii w sieci wyszukiwania:

Usługi Lokalne

Jeśli w przypadku danej rozmowy z potencjalnym klientem Usług Lokalnych nie istnieje nagranie rozmowy telefonicznej, parametr PhoneCallDetails.call_recording_url będzie pusty, a nie będzie zawierać nieprawidłowego adresu URL.
Dodano kolumnę CategoryBid.target_cpa_bid_micro, która umożliwia ustawienie docelowego CPA dla danej kategorii za pomocą kolumny Campaign.local_services_campaign_settings.

Performance Max

Wskazówki dotyczące marki
- Dodano Campaign.brand_guidelines_enabled, który pokazuje, czy wskazówki dotyczące marki są włączone w danej kampanii Performance Max. Jeśli ta opcja jest włączona, zasoby z wartością field_type ustawioną na BUSINESS_NAME, LOGO lub LANDSCAPE_LOGO muszą być połączone jako zasoby CampaignAsset zamiast zasobów AssetGroupAsset.
- Dodano błędy CampaignError.REQUIRED_BUSINESS_NAME_ASSET_NOT_LINKED i CampaignError.REQUIRED_LOGO_ASSET_NOT_LINKED, które wskazują, że kampanie Performance Max z włączonymi wskazówkami dotyczącymi marki nie mają powiązanych z nimi wymaganych zasobów CampaignAsset.
- Gdy włączone są wytyczne dotyczące marki, do kampanii musi być co najmniej 1 komponent z ustawionym parametrem field_type BUSINESS_NAME i co najmniej 1 komponent z parametrem LOGO CampaignAsset. Kampanie Performance Max nastawione na sprzedaż online za pomocą pliku danych o produktach muszą spełniać ten wymóg tylko wtedy, gdy są w nich komponenty powiązane z grupami plików kampanii.
- Do wartości AssetLinkError dodaliśmy te wartości:
  - BRAND_ASSETS_NOT_LINKED_AT_ASSET_GROUP_LEVEL, która jest zgłaszana podczas próby połączenia komponentów marki z kampaniami jako komponentów CampaignAsset zamiast komponentów AssetGroupAsset w kampaniach Performance Max z niewłączonymiwytycznymi dotyczącymi marki.
  - błąd BRAND_ASSETS_NOT_LINKED_AT_CAMPAIGN_LEVEL, który występuje podczas próby połączenia komponentów marki z kampaniami jako komponentów AssetGroupAsset zamiast komponentów CampaignAsset w kampaniach Performance Max z włączonymi wskazówkami dotyczącymi marki.
Dodaliśmy kolumnę performance_max_placement_view, która zwraca wyświetlenia w miejscach docelowych, w których wyświetlały się reklamy z kampanii Performance Max.
Dodano stronę AssetGroupListingGroupFilterError.TREE_WAS_INVALID_BEFORE_MUTATION

Planowanie

(Tylko dla kont na liście dozwolonych) Dodano nową usługę z metodą ContentCreatorInsightsService.GenerateCreatorInsights, która umożliwia użytkownikom poznawanie statystyk najlepszych twórców YouTube. Dzięki temu klienci mogą wyszukiwać twórców na podstawie kombinacji kierowania na odbiorców i kierowania na treści lub statystyk twórców na podstawie listy identyfikatorów kanałów YouTube.
Aktualizacje AudienceInsightsService.GenerateSuggestedTargetingInsights:
- Elementy audience, baseline_audience i data_month zostały przeniesione do audience_definition.
- Dodano audience_description, aby za pomocą generatywnej AI generować sugestie kierowania na podstawie opisu tekstowego w formie swobodnego tekstu.
Dodano funkcję AudienceInsightsService.GenerateTargetingSuggestionMetrics, która zwraca dane o potencjalnym zasięgu w przypadku określonych kombinacji kierowania na odbiorców.

Rekomendacje

RecommendationService.GenerateRecommendations może teraz służyć do generowania rekomendacji dotyczących sugestii optymalizacji budżetu podczas tworzenia kampanii. Aby to zrobić, musisz uwzględnić typ rekomendacji CAMPAIGN_BUDGET w sekcji GenerateRecommendationsRequest.recommendation_types[]. Ta funkcja działa w przypadku kampanii Performance Max i kampanii w sieci wyszukiwania.

Raportowanie

Pola summary_row_setting i return_total_results_count w kolumnie SearchGoogleAdsRequest zostały zastąpione polem search_settings typu SearchSettings, które zawiera te pola:
- omit_results
- return_summary_row
- return_total_results_count
Dodaliśmy te nowe dane dotyczące ogólnych nieprawidłowych kliknięć, np. kliknięć generowanych przez boty lub roboty indeksujące, kliknięć o nieregularnych wzorach. Można je wyszukiwać za pomocą raportu campaign.
- metrics.general_invalid_clicks
- metrics.general_invalid_click_rate
Do wartości QuotaError dodaliśmy te wartości:
- EXCESSIVE_SHORT_TERM_QUERY_RESOURCE_CONSUMPTION
- EXCESSIVE_LONG_TERM_QUERY_RESOURCE_CONSUMPTION

17.1.0 (7.08.2024)

W wersji 17_1 dodaliśmy te nowe funkcje i aktualizacje.

Zasoby

AdGroupAdService.RemoveAutomaticallyCreatedAssets() umożliwia usunięcie określonych komponentów tworzonych automatycznie powiązanych z elatycznymi reklamami w wyszukiwarce.

Odbiorcy

Nowe wartości typu wyliczeniowego w atrybucie UserListCustomerTypeCategory:
- LOYALTY_TIER_1_MEMBERS
- LOYALTY_TIER_2_MEMBERS
- LOYALTY_TIER_3_MEMBERS
- LOYALTY_TIER_4_MEMBERS
- LOYALTY_TIER_5_MEMBERS
- LOYALTY_TIER_6_MEMBERS
- LOYALTY_TIER_7_MEMBERS

Kampanie

ShareablePreviewService.GenerateShareablePreviews() generuje adresy URL (shareable_preview_url w odpowiedzi) podglądów reklam, które można udostępnić, w przypadku włączonych i wstrzymanych grup komponentów.
- Pole expiration_date_time wskazuje datę wygaśnięcia adresów URL w odpowiedzi.
- W przypadku wystąpienia błędu zamiast adresów URL metoda zwróci wartość partial_failure_error.

Historia zmian

Nowy typ zasobu zmiany stanu: ASSET_GROUP.

Konwersje

Nowe pole segmentu w wersji SKAdNetwork: segments.sk_ad_network_version
offline_conversion_upload_conversion_action_summary, która zawiera diagnostykę przesyłania konwersji na poziomie działania powodującego konwersję.
Aby podać liczbę przesłanych konwersji, które są jeszcze przetwarzane, do raportów diagnostycznych offline dodawane są te dane:
- offline_conversion_upload_client_summary
  - pending_event_count
  - pending_rate
- offline_conversion_upload_conversion_action_summary:
  - pending_count

Planowanie

AudienceInsights.GenerateAudienceOverlapInsights(), która przyjmuje jako dane wejściowe atrybut główny i zbiór atrybutów listy odbiorców, a następnie zwraca szacowane pokrycie potencjalnego zasięgu w YouTube między atrybutem głównym a atrybutami listy odbiorców.

Raportowanie

Obsługa podziału na segmenty według właściwości per_store_view na podstawie atrybutu segments.date

Filmy

Obsługa pobierania informacji związanych z tymi standardowymi strategiami ustalania stawek w przypadku kampanii wideo za pomocą raportów, takich jak ad_group i campaign:
- Campaign.fixed_cpm (stały CPM (koszt tysiąca wyświetleń))
- Campaign.target_cpv (Docelowy CPV (koszt obejrzenia))
Campaign.video_campaign_settings, która pozwala określić, w jakich zasobach reklamowych mogą się wyświetlać reklamy wideo. W tym celu możesz użyć tych pól raportu:
segments.ad_format_type, która umożliwia podział na segmenty w tych raportach na podstawie typu formatu reklamy wideo:

17 (5.06.2024)

W wersji 17 dodano te funkcje i zmiany:

Reklamy

Użytkownik AdService.getAd został usunięty. Dzięki temu interfejs AdService będzie zgodny z innymi usługami w interfejsie Google Ads API. Zapoznaj się z artykułem Pobieranie obiektów, aby dowiedzieć się, jak pobierać reklamy i inne typy zasobów.
Dodano więcej weryfikacji ImageAdInfo.image_asset dotyczących wymiarów i formatu. Jeśli obraz jest nieprawidłowy, mogą wystąpić te błędy:
- ImageError.UNEXPECTED_SIZE
- ImageError.FORMAT_NOT_ALLOWED

Zasoby

Dodano nowy typ wyliczeniowy: ClickType.AD_IMAGE
Dodaliśmy nowe raporty z nowymi danymi dla kampanii Performance Max i kampanii w sieci wyszukiwania:
- campaign_aggregate_asset_view
- channel_aggregate_asset_view

Odbiorcy

Dodano stronę OfflineUserDataJobError.OPERATION_LEVEL_CONSENT_PROVIDED

Zadania wsadowe

Dodano parametr BatchJobError.REQUEST_TOO_LARGE, który zostanie wywołany, gdy przesłany parametr AddBatchJobOperationsRequest będzie większy niż 10484504 bajty.
Dodano obsługę ustawienia MutateOperation.asset_group_operation podczas używania BatchJobService. Dzięki temu możesz używać przetwarzania w partiach do tworzenia i zarządzania całymi kampaniami Performance Max. Zapoznaj się z naszym nowym przewodnikiem.

Kampanie

Zmieniliśmy nazwę „Discovery” na „Demand Gen” we wszystkich polach, typach danych i błędach wszystkich zasobów interfejsu Google Ads API, takich jak kampanie, reklamy i komponenty. Na przykład: AdvertisingChannelType.DISCOVERY to teraz AdvertisingChannelType.DEMAND_GEN.
Dodano Campaign.keyword_match_type, aby umożliwić Ci ustawianie typu dopasowania słów kluczowych we wszystkich słowach w kampanii.

Konwersje

W przypadku konwersji SKAdNetwork:
- Nazwa segments.sk_ad_network_conversion_value została zmieniona na segments.sk_ad_network_fine_conversion_value.
- Dodano stronę segments.sk_ad_network_redistributed_fine_conversion_value.
Te dane są teraz zwracane w odpowiedzi nawet wtedy, gdy ich wartość wynosi 0. Dzięki temu są one spójne z innymi danymi.

Kryteria

Do tych pól dodano kolumnę AdGroupCriterion, aby wyświetlać informacje o tym, czy kryterium w grupie reklam jest wyświetlane, czy nie, oraz o przyczynach, dla których nie jest wyświetlane:
- primary_status
- primary_status_reasons
Dodaliśmy obsługę metrics.search_impression_share gender_view
Dodaliśmy obsługę właściwości metrics.phone_calls w przypadku keyword_view

Usługi Lokalne

Dodano parametr LocalServicesLeadService.AppendLeadConversation(), który służy do dołączania nowych rekordów LocalServicesLeadConversation do LocalServicesLead. Dzięki temu wiadomości są wysyłane do użytkowników odpowiednimi kanałami, np. SMS-em, w zależności od sposobu utworzenia potencjalnego klienta.
- Rozmiar AppendLeadConversationRequest.conversations jest ograniczony do 1000.
- W Conversation.local_services_lead można określić tylko parametr LocalServicesLead z wartością lead_type LeadType.MESSAGE.
Dodano nowe wartości typu wyliczeniowego do kolumny ConversationType:
- WHATSAPP, aby reprezentować rozmowę prowadzoną w WhatsApp.
- ADS_API, aby reprezentować rozmowę wprowadzoną za pomocą nowej metody LocalServicesLeadService.AppendLeadConversation().
Dodaliśmy do pola local_services_verification_artifact te nowe pola:
- local_services_verification_artifact.insurance_verification_artifact.expiration_date_time
- local_services_verification_artifact.license_verification_artifact.expiration_date_time

Raportowanie

Podczas wysyłania zapytania product_link możesz teraz wybrać tylko pola powiązane z jednym połączonym produktem. Wybranie wielu pól wielu połączonych produktów spowoduje błąd QueryError.PROHIBITED_FIELD_COMBINATION_IN_SELECT_CLAUSE. Na przykład:product_link.advertising_partner.customer i product_link.data_partner.data_partner_id nie mogą być wybrane w tym samym zapytaniu.
Przekazywanie wartości page_size do funkcji GoogleAdsService.Search spowoduje błąd RequestError.PAGE_SIZE_NOT_SUPPORTED.

kampania produktowa.

Dodaliśmy nowy raport shopping_product, który odpowiada stronie Produkty w interfejsie Google Ads. Obsługuje ona zwracanie danych dotyczących bieżącego stanu produktów z kont Merchant Center połączonych z kontem Google Ads.
- Dane w raporcie shopping_product możesz filtrować za pomocą filtra segments.date, gdy korzystasz z opcji GoogleAdsService.Search lub GoogleAdsService.SearchStream. Segmentacja według daty jest niedozwolona i spowoduje błąd ShoppingProductError.UNSUPPORTED_DATE_SEGMENTATION.

Cele ujednolicone

Dodano UserListCustomerTypeService.MutateUserListCustomerTypes(), aby skonfigurować typy klientów odbiorców.
Użytkownik CustomerLifecycleGoal.lifecycle_goal_customer_definition_settings został usunięty. Aby skonfigurować ustawienia list odbiorców celów związanych z cyklem życia klienta, użyj zamiast tego reguły UserListCustomerTypeService.MutateUserListCustomerTypes().
- Załącz lub odłącz listę użytkowników, ustawiając parametr UserListCustomerType.customer_type_category na UserListCustomerTypeCategory.PURCHASERS, aby odpowiednio uwzględnić lub wykluczyć ją z obecnej definicji klienta na potrzeby celów związanych z cyklem życia klienta. Aby dowiedzieć się więcej, przeczytaj artykuł Podział odbiorców na segmenty.

Filmy

Do ContentLabelType dodano te wartości: Na poziomie klienta możesz wykluczyć te ContentLabelTypes:
- BRAND_SUITABILITY_CONTENT_FOR_FAMILIES
- BRAND_SUITABILITY_GAMES_FIGHTING
- BRAND_SUITABILITY_GAMES_MATURE
- BRAND_SUITABILITY_HEALTH_SENSITIVE
- BRAND_SUITABILITY_HEALTH_SOURCE_UNDETERMINED
- BRAND_SUITABILITY_NEWS_RECENT
- BRAND_SUITABILITY_NEWS_SENSITIVE
- BRAND_SUITABILITY_NEWS_SOURCE_NOT_FEATURED
- BRAND_SUITABILITY_POLITICS
- BRAND_SUITABILITY_RELIGION
Dodaliśmy parametr AdVideoAsset.ad_video_asset_info, aby umożliwić preferencje dotyczące zasobów wideo podczas tworzenia DemandGenVideoResponsiveAdInfo.
(tylko konta na liście dozwolonych) Umożliwiono Campaign.video_brand_safety_suitabilitymodyfikowanie.

Archiwalne informacje o wersjach

Aby wyświetlić zarchiwizowane informacje o wersji, kliknij Wycofane wersje.