Yeni Search Ads 360 Reporting API kullanıma sunuldu. Yaklaşan geliştirmeler ve sürümlerden haberdar olmak için
searchads-api-announcements Google grubuna katılın.
Search Ads 360 Reporting API yapısı
Koleksiyonlar ile düzeninizi koruyun
İçeriği tercihlerinize göre kaydedin ve kategorilere ayırın.
Search Ads 360 Reporting API'nin birincil bileşenleri kaynaklar ve hizmetler'dir. Kaynak, bir Search Ads 360 öğesini temsil eder ve Search Ads 360 öğelerini almak için bir hizmet kullanırsınız.
Nesne hiyerarşisi
Search Ads 360 hesabı, nesne hiyerarşisidir.
Hesabın üst düzey kaynağı müşteridir.
Her hesapta bir veya daha fazla etkin kampanya bulunur.
Her Campaign, reklamlarınızı mantıksal koleksiyonlar halinde gruplandıran bir veya daha fazla reklam grubu içerir.
Her AdGroup, bir veya daha fazla reklam grubu reklamı içerir.
Bir reklam grubuna veya kampanyaya bir veya daha fazla AdGroupCriterion ya da CampaignCriterion ekleyebilirsiniz. Ölçütler, reklamların nasıl tetikleneceğini tanımlar.
- Anahtar kelimeler, yaş aralıkları ve konumlar gibi birçok ölçüt türü vardır. Kampanya düzeyinde tanımlanan ölçütler, kampanyadaki diğer tüm kaynakları etkiler. Kampanya genelinde bütçeler ve tarihler de belirtebilirsiniz.
Kaynaklar
Kaynaklar, Search Ads 360 hesabınızdaki öğeleri temsil eder. Kaynaklara örnek olarak Customer, Campaign ve AdGroup verilebilir.
Nesne Kimlikleri
Search Ads 360'taki her nesne kendi kimliğiyle tanımlanır. Bazı kimlikler global olarak benzersizdir, yani tüm Search Ads 360 hesaplarında benzersizdir. Bazı kimlikler ise yalnızca sınırlı bir kapsam dahilinde benzersizdir.
| Nesne kimliğinin benzersizlik kapsamı |
| Bütçe Kimliği |
Global |
| Kampanya Kimliği |
Global |
| Reklam Grubu Kimliği |
Global |
| Reklam Kimliği |
Reklam GrubuHer AdGroupId / AdId çifti dünya genelinde benzersizdir. |
| AdGroupCriterion kimliği |
Reklam GrubuHer AdGroupId / CriterionId çifti dünya genelinde benzersizdir. |
| CampaignCriterion kimliği |
KampanyaHer CampaignId / CriterionId çifti dünya genelinde benzersizdir. |
| Reklam Uzantıları |
KampanyaHer CampaignId / AdExtensionId çifti genel olarak benzersizdir. |
| Özet akışı kimliği |
Global |
| Feed Öğe Kimliği |
Global |
| Feed Özelliği Kimliği |
Feed |
| Özet Akışı Eşleme Kimliği |
Global |
| Etiket Kimliği |
Global |
| UserList kimliği |
Global |
Bu kimlik kuralları, Search Ads 360 nesneleriniz için yerel depolama alanı tasarlarken yararlı olabilir.
Nesne türleri
Bazı nesneler birden fazla varlık türü için kullanılabilir. Bu durumda, nesne içeriğini açıklayan bir type alanı içerir. Örneğin AdGroupAd bir metin reklam, otel reklamı veya yerel reklama işaret edebilir.
Tür değerine AdGroupAd.ad.type alanı üzerinden erişebilirsiniz. Değeri, AdType enum'unda döndürülür.
Kaynak adları
Her kaynak, kaynağı ve üst öğelerini bir yola bağlayan bir resource_name dizesi ile benzersiz şekilde tanımlanır.
Örneğin, kampanya kaynak adları şu şekildedir:
customers/CUSTOMER_ID/campaigns/CAMPAIGN_ID
Müşteri kimliği 1234567 olan Search Ads 360 hesabında 987654 kimliğine sahip bir kampanyanın resource_name değeri:
customers/1234567/campaigns/987654
Hizmetler
Hizmetler, Search Ads 360 varlıklarınızı ve meta verilerinizi almanıza olanak tanır. Üç hizmet türü vardır:
- Arama hizmeti
SearchAds360Service, tüm kaynak nesnelerini ve performans istatistiklerini almak için kullanılan tek, birleşik bir hizmettir. İki yöntem sunar: Search ve SearchStream. Her iki yöntem de sorgulanacak kaynağı, alınabilecek kaynak özelliklerini ve performans metriklerini, isteği filtrelemek için kullanılacak önermelerin yanı sıra performans istatistiklerini daha ayrıntılı şekilde incelemek için kullanılacak segmentleri belirten bir sorgu gerektirir. Daha fazla bilgi için Arama raporu oluşturma ve Search Ads 360 Sorgu Dili başlıklı makalelere göz atın.- Saha hizmeti
SearchAds360FieldService, kaynaklar hakkındaki meta verileri (ör. bir kaynağın kullanılabilir özellikleri ve veri türü) alır. SearchAds360Service arama yöntemlerinde kullanılabilen kaynaklar, kaynak alanları, segmentasyon anahtarları ve metrikler için katalog isteyebilirsiniz. Daha fazla bilgi için Kaynak meta verilerini alma başlıklı makaleyi inceleyin.- Tüzel kişiye özel hizmetler
Bu hizmetler, tek bir kaynak örneği alan bir GET istek yöntemi sağlar. Bu, bir kaynağın yapısını incelemek için yararlıdır.
Varlığa özel hizmetlere örnekler:
Aksi belirtilmediği sürece bu sayfanın içeriği Creative Commons Atıf 4.0 Lisansı altında ve kod örnekleri Apache 2.0 Lisansı altında lisanslanmıştır. Ayrıntılı bilgi için Google Developers Site Politikaları'na göz atın. Java, Oracle ve/veya satış ortaklarının tescilli ticari markasıdır.
Son güncelleme tarihi: 2025-08-29 UTC.
[null,null,["Son güncelleme tarihi: 2025-08-29 UTC."],[[["\u003cp\u003eThe Search Ads 360 Reporting API uses resources to represent Search Ads 360 entities and services to retrieve them, with the core being the SearchAds360Service for comprehensive data retrieval.\u003c/p\u003e\n"],["\u003cp\u003eSearch Ads 360 accounts are structured hierarchically, starting with the customer resource at the top, followed by campaigns, ad groups, ads, and criteria for targeting.\u003c/p\u003e\n"],["\u003cp\u003eEvery Search Ads 360 object has a unique ID, some globally and others within a specific scope like an ad group or campaign, which is important for data management.\u003c/p\u003e\n"],["\u003cp\u003eResources are identified by resource names, which are strings that combine the resource and its parent resources in a path format, such as customers/CUSTOMER_ID/campaigns/CAMPAIGN_ID.\u003c/p\u003e\n"],["\u003cp\u003eThe Search Ads 360 Reporting API provides services like SearchAds360Service for data retrieval, SearchAds360FieldService for resource metadata, and entity-specific services for detailed information on individual resources like custom columns.\u003c/p\u003e\n"]]],["The Search Ads 360 Reporting API uses resources (entities) and services (retrieval methods). Resources, like `Customer`, `Campaign`, and `AdGroup`, are organized hierarchically. Each object has a unique ID with varying scopes and a `resource_name` for identification. Services include `SearchAds360Service` to retrieve resources and statistics, `SearchAds360FieldService` for metadata, and entity-specific services for individual resource instances. `SearchAds360Service` uses queries with attributes, metrics, predicates, and segments to filter data.\n"],null,["# Search Ads 360 Reporting API structure\n\nThe primary components of the Search Ads 360 Reporting API are *resources* and\n*services*. A resource represents a Search Ads 360 entity and you use a service\nto retrieve Search Ads 360 entities.\n\nObject hierarchy\n----------------\n\nA Search Ads 360 account is a hierarchy of objects.\n\n- The top-level resource of an account is the [customer](/search-ads/reporting/api/reference/fields/v0/customer).\n\n- Each account contains one or more active [campaigns](/search-ads/reporting/api/reference/fields/v0/campaign).\n\n- Each `Campaign` contains one or more [ad groups](/search-ads/reporting/api/reference/fields/v0/ad_group) that group your ads into\n logical collections.\n\n- Each `AdGroup` contains one or more [ad group ads](/search-ads/reporting/api/reference/rpc/ad_group_ad).\n\n- You can attach one or more [`AdGroupCriterion`](/search-ads/reporting/api/reference/fields/v0/ad_group_criterion) or [`CampaignCriterion`](/search-ads/reporting/api/reference/fields/v0/campaign_criterion)\n to an ad group or campaign. Criteria define how ads are triggered.\n\n - There are many [criterion types](), such as, keywords, age ranges, and locations. Criteria defined at the campaign level affect all other resources within the campaign. You can also specify campaign-wide budgets and dates.\n\nResources\n---------\n\nResources represent the entities in your Search Ads 360 account. Example\nresources include [`Customer`](/search-ads/reporting/api/reference/fields/v0/customer), [`Campaign`](/search-ads/reporting/api/reference/fields/v0/campaign) and [`AdGroup`](/search-ads/reporting/api/reference/fields/v0/ad_group).\n\n### Object IDs\n\nEvery object in Search Ads 360 is identified by its own ID. Some IDs are\nglobally unique, that is, across all Search Ads 360 accounts, while others\nare unique only within a confined scope.\n\n| Object ID uniqueness scope ||\n|----------------------|------------------------------------------------------------------------------|\n| Budget ID | Global |\n| Campaign ID | Global |\n| AdGroup ID | Global |\n| Ad ID | Ad Group \u003cbr /\u003e Each `AdGroupId` / `AdId` pair is globally unique. |\n| AdGroupCriterion ID | Ad Group \u003cbr /\u003e Each `AdGroupId` / `CriterionId` pair is globally unique. |\n| CampaignCriterion ID | Campaign \u003cbr /\u003e Each `CampaignId` / `CriterionId` pair is globally unique. |\n| Ad Extensions | Campaign \u003cbr /\u003e Each `CampaignId` / `AdExtensionId` pair is globally unique. |\n| Feed ID | Global |\n| Feed Item ID | Global |\n| Feed Attribute ID | Feed |\n| Feed Mapping ID | Global |\n| Label ID | Global |\n| UserList ID | Global |\n\nThese ID rules can be useful when designing local storage for your Search Ads\n360 objects.\n\n### Object types\n\nSome objects can be used for multiple entity types. If this is the case, the\nobject contains a `type` field that describes its contents. For example,\n[`AdGroupAd`](/search-ads/reporting/api/reference/rpc/ad_group_ad) can refer to a text ad, hotel ad, or local ad.\nYou can access the type value through the [`AdGroupAd.ad.type`](/search-ads/reporting/api/reference/rpc/add_group_ad) field. Its\nvalue is returned in the [`AdType`](/search-ads/reporting/api/reference/rpc/google.ads.searchads360.v0.enums#adtypeenum) enum.\n\n### Resource names\n\nEach resource is uniquely identified by a `resource_name` string that\nconcatenates the resource and its parents into a path.\n\nCampaign resource names, for example, have the form: \n\n```scdoc\ncustomers/CUSTOMER_ID/campaigns/CAMPAIGN_ID\n```\n\nA campaign with ID `987654` in the Search Ads 360 account with customer ID\n`1234567`, has the `resource_name`: \n\n```text\ncustomers/1234567/campaigns/987654\n```\n\nServices\n--------\n\nServices let you retrieve your Search Ads 360 entities and metadata. There a\nthree service types:\n\nSearch service\n: [`SearchAds360Service`](/search-ads/reporting/api/reference/rpc/google.ads.searchads360.v0.services#searchads360service) is the single, unified service for retrieving all\n resource objects and performance statistics. It provides two methods: *`Search`*\n and *`SearchStream`* . Both methods require require a query that specifies the\n resource to query, the resource attributes and performance metrics to retrieve,\n the predicates to use for filtering the request, and the segments to use to\n further break down performance statistics. See [Create search reports](/search-ads/reporting/concepts/search-reports) and [Search\n Ads 360 Query Language](/search-ads/reporting/concepts/query-language) for more\n information.\n\nField service\n: [`SearchAds360FieldService`](/search-ads/reporting/api/reference/rpc/google.ads.searchads360.v0.services#searchads360fieldservice) retrieves metadata\n about resources, such as, the available attributes for a resource and its data\n type. You can request the catalog for resources, resource fields, segmentation\n keys, and metrics available in the `SearchAds360Service` search methods. See\n [Retrieve resource metadata](/search-ads/reporting/concepts/field-service)\n to learn more.\n\nEntity-specific services\n\n: These services provide a `GET` request method that retrieves a single resource\n instance. This is useful for examining the structure of a resource.\n\n Examples of entity-specific services include:\n\n - [CustomColumnService](/search-ads/reporting/api/reference/rpc/google.ads.searchads360.v0.services#customcolumnservice) that returns the requested custom column in full detail."]]
