Nesne alma

GoogleAdsService, Google Ads API'nin birleştirilmiş nesne alma ve raporlama hizmetidir. Hizmetin aşağıdaki gibi yöntemleri vardır:

• Nesnelerin belirli özelliklerini alma
• Nesnelerin performans metriklerini bir tarih aralığına göre alın.
• Nesneleri özelliklerine göre sıralayın.
• Yanıt olarak hangi nesnelerin döndürülmesini istediğinizi belirtmek için koşulları kullanın.
• Döndürülen nesne sayısını sınırlayın.

GoogleAdsService, sonuçları iki şekilde döndürebilir:

• GoogleAdsService.SearchStream 10.000'den fazla satır içeren büyük sonuç kümeleri için daha verimli olan tek bir yayın yanıtında tüm satırları döndürür. Uygulamanız tam sonuç kümelerini indiriyorsa veya satırları akış olarak işliyorsa bu yöntem önerilir.
• GoogleAdsService.Search, büyük yanıtları yönetilebilir sonuç sayfalarına ayırır. Bu, etkileşimli uygulamanızda sonuçların her seferinde bir sayfa olarak gösterildiği durumlarda yararlıdır.

Sayfalama ve akış hakkında daha fazla bilgi edinin.

İstekte bulunun

GoogleAdsService.SearchStream parametresi SearchGoogleAdsStreamRequest, GoogleAdsService.Search parametresi ise SearchGoogleAdsRequest değerini bekliyor. Her iki istek türünde de şunlar yer alır:

• customer_id
• Hangi kaynağın sorgulanacağını, alınacak özelliklerin, segmentlerin ve metriklerin, döndürülen nesnelerin sınırlandırılması için kullanılacak koşulların belirtildiği bir Google Ads Query Language query

İsteğin yönteme bağlı olarak yönteme özgü alanları da desteklediğini unutmayın:

• SearchGoogleAdsStreamRequest (yalnızca SearchStream):
  • Toplu metrikler içeren bir özet satırı istemek için isteğe bağlı summary_row_setting
• SearchGoogleAdsRequest (yalnızca Search):
  • Sayfalama kullanılırken sonraki sonuç grubunu almak için isteğe bağlı page_token (page_size 10.000 satır olarak sabitlenmiştir; istekte page_size ayarlanırsa RequestError.PAGE_SIZE_NOT_SUPPORTED hatası verilir)
  • return_summary_row, return_total_results_count ve omit_results yapılandırmak için isteğe bağlı bir search_settings mesajı
  • Sorguyu yürütmeden doğrulamak için isteğe bağlı bir validate_only Boole değeri

Google Ads Sorgu Dili hakkında daha fazla bilgi için Google Ads Sorgu Dili kılavuzunu inceleyin.

Yanıt işleme

GoogleAdsService, GoogleAdsRow nesnelerinin (aktarılan SearchGoogleAdsStreamResponse gruplarının içinde veya sayfalandırılmış SearchGoogleAdsResponse içinde) listesini döndürür.

Her GoogleAdsRow, bir sorgu tarafından döndürülen bir nesneyi temsil eder ve SELECT ifadesinde istenen alanlara göre doldurulan bir dizi özellikten oluşur. SELECT ifadesine dahil edilmeyen özellikler, yanıttaki GoogleAdsRow nesnelerinde doldurulmaz.

Örneğin, bir ad_group_criterion öğesinin status özelliği olmasına rağmen SELECT ifadesi ad_group_criterion.status öğesini içermeyen bir sorguya verilen yanıtta satırın ad_group_criterion özelliğinin status alanı doldurulmaz. Benzer şekilde, SELECT campaign kaynaklarından herhangi bir alan içermiyorsa satırın campaign özelliği doldurulmaz.

Aynı sonuç kümesindeki her GoogleAdsRow, başka bir satırdan farklı özelliklere ve metriklere sahip olabilir. Bu nedenle satırlar, tablonun sabit satırları yerine nesneler olarak görüntülenmelidir.

UNKNOWN ve UNSPECIFIED enum türleri

UNKNOWN enum değeriyle döndürülen kaynaklar, söz konusu API sürümünde tam olarak desteklenmez. UNSPECIFIED ise bir enum alanının ayarlanmadığını veya SELECT ifadesinde istenmediğini gösterir. UNKNOWN enum değerine sahip kaynaklar, Google Ads kullanıcı arayüzü gibi diğer arayüzler aracılığıyla oluşturulmuş olabilir. Bir kaynağın türü UNKNOWN olduğunda metrikleri seçebilirsiniz ancak kaynağı API üzerinden değiştiremezsiniz. Buna örnek olarak, sorguladığınız API sürümünde desteklenmeyen ve kullanıcı arayüzünde kullanılabilen bir kampanya veya reklam türü verilebilir.

Aşağıda dikkat edilmesi gereken noktalardan bazılarını görebilirsiniz:

• UNKNOWN türündeki bir kaynak, daha sonraki bir API sürümünde desteklenebilir veya süresiz olarak UNKNOWN kalabilir.
• UNKNOWN türündeki yeni nesneler herhangi bir zamanda görünebilir. Bu nesneler, API'deki her enum'da UNKNOWN enum değeri bulunduğundan geriye dönük olarak uyumludur. Kaynaklar, hesabınızın genel performans metrikleri hakkında doğru bir görünüm elde etmeniz için UNKNOWN ile birlikte döndürülür.
• UNKNOWN kaynaklarına, sorgulanabilir ayrıntılı metrikler eklenebilir.
• UNKNOWN kaynakları genellikle Google Ads kullanıcı arayüzünde tamamen görünür.
• UNKNOWN kaynakları genellikle API aracılığıyla değiştirilemez.

Segmentasyon

Yanıtta, aşağıdakilerin her bir kombinasyonu için bir GoogleAdsRow yer alıyor:

• FROM ifadesinde belirtilen ana kaynağın örneği
• Seçilen her segments alanın değeri

Örneğin, FROM campaign öğesini seçen ve SELECT tümcesinde segments.ad_network_type ile segments.date öğelerini içeren bir sorgunun yanıtı, aşağıdakilerin her kombinasyonu için bir satır içerir:

• campaign
• segments.ad_network_type
• segments.date

Sonuçlar, seçilen alanların değerlerine göre değil, ana kaynağın her bir örneğine göre örtülü olarak segmentlere ayrılır. Örneğin,

SELECT campaign.status, metrics.impressions
FROM campaign
WHERE segments.date DURING LAST_14_DAYS

campaign.status alanının her farklı değeri için bir satır yerine kampanya başına bir satırla sonuçlanır.