Video: Reporting (Video: Raporlama)
Google Ads API'de, Google Ads sorgu dilini kullanarak sorgular oluşturmanıza olanak tanıyan birleşik bir özellik alma ve metrik raporlama mekanizması bulunur. Bu, bireysel Google Ads hesapları hakkında büyük miktarda veri döndürebilen karmaşık sorguları etkinleştirir.
Search veya SearchStream yöntemlerinden birini kullanarak sorgu oluşturabilirsiniz.
Her iki yöntem de aynı sorguları destekler ve eşdeğer sonuçlar döndürür. Search yöntemi,verileri 10.000 satırlık sabit boyutlu sayfalar halinde döndürür. Böylece, sonuç kümesinde sayfalara ayırma özelliğini kullanarak yineleme yapabilirsiniz. Örneğin, düşük bant genişliğine sahip veya güvenilir olmayan ağ koşullarında bu özellik avantajlı olabilir. Bağlantı kesilirse yeniden getirilebilecek daha küçük yanıtlar oluşturmak için büyük bir sonuç kümesini segmentlere ayırabilirsiniz. Diğer yandan SearchStream yöntemi, tüm sonuç kümesini tek bir yanıtta geri aktarır. Bu yöntem, toplu veri alma için daha verimli olabilir.
Hem Search hem de SearchStream aynı temel URL'yi kullanıyor:
https://googleads.googleapis.com/v20/customers/CUSTOMER_ID/googleAds
POST /v20/customers/CUSTOMER_ID/googleAds:search HTTP/1.1 Host: googleads.googleapis.com Content-Type: application/json Authorization: Bearer ACCESS_TOKEN developer-token: DEVELOPER_TOKEN { "query": "SELECT ad_group_criterion.keyword.text, ad_group_criterion.status FROM ad_group_criterion WHERE ad_group_criterion.type = 'KEYWORD' AND ad_group_criterion.status = 'ENABLED'" }
Sonuçlarda 10.000'den fazla satır varsa yanıtta nextPageToken döndürülür:
{ "results": [ // ... // ... // ... ], "nextPageToken": "CPii5aS87vfFTBAKGJvk36qpLiIWUW5SZk8xa1JPaXJVdXdIR05JUUpxZyoCVjMwADjUBkD___________8B", "fieldMask": "adGroupCriterion.keyword.text,adGroupCriterion.status" }
Önceki isteğin değerleriyle eklenen bir pageToken ile aynı sorguyu tekrarlamak, sonuçların bir sonraki sayfasını getirir:
POST /v20/customers/CUSTOMER_ID/googleAds:search HTTP/1.1 Host: googleads.googleapis.com Content-Type: application/json Authorization: Bearer ACCESS_TOKEN developer-token: DEVELOPER_TOKEN { "query": "SELECT ad_group_criterion.keyword.text, ad_group_criterion.status FROM ad_group_criterion WHERE ad_group_criterion.type = 'KEYWORD' AND ad_group_criterion.status = 'ENABLED'", "pageToken": "CPii5aS87vfFTBAKGJvk36qpLiIWUW5SZk8xa1JPaXJVdXdIR05JUUpxZyoCVjMwADjUBkD___________8B" }
Tüm sonuçları tek bir yayınlanmış yanıtta döndüren SearchStream yöntemini kullanmak için URL'deki hizmet yöntemini searchStream olarak değiştirin (pageToken, SearchStream tarafından gerekli değildir):
POST /v20/customers/CUSTOMER_ID/googleAds:searchStream HTTP/1.1 Host: googleads.googleapis.com Content-Type: application/json Authorization: Bearer ACCESS_TOKEN developer-token: DEVELOPER_TOKEN { "query": "SELECT ad_group_criterion.keyword.text, ad_group_criterion.status FROM ad_group_criterion WHERE ad_group_criterion.type = 'KEYWORD' AND ad_group_criterion.status = 'ENABLED'" }