Arama sorgusuyla eşleşen tüm satırları döndürür.
Verilen hataların listesi: AuthenticationError AuthorizationError HeaderError InternalError QueryError QuotaError RequestError
HTTP isteği
POST https://searchads360.googleapis.com/v0/customers/{customerId}/searchAds360:search
URL, gRPC Kod Dönüştürme söz dizimini kullanır.
Yol parametreleri
Parametreler | |
---|---|
customerId |
Zorunlu. Sorgulanan müşterinin kimliği. |
İstek içeriği
İsteğin gövdesi, aşağıdaki yapıya sahip veriler içerir:
JSON gösterimi |
---|
{
"query": string,
"pageToken": string,
"pageSize": integer,
"validateOnly": boolean,
"returnTotalResultsCount": boolean,
"summaryRowSetting": enum ( |
Alanlar | |
---|---|
query |
Zorunlu. Sorgu dizesi. |
pageToken |
Alınacak sayfanın jetonu. Belirtilmezse, sonuçların ilk sayfası döndürülür. Sonraki sonuç sayfasını istemek için önceki yanıtta |
pageSize |
Tek bir sayfada alınacak öğe sayısı. Çok büyük bir sayfa istendiğinde sunucu, döndürülen kaynakların sayısını daha da sınırlandırmaya karar verebilir. |
validateOnly |
Doğru ise istek doğrulanır ancak yürütülmez. |
returnTotalResultsCount |
Doğru ise, LIMIT deyimi yok sayılarak sorguyla eşleşen sonuçların toplam sayısı yanıta dahil edilir. Varsayılan değer, false (yanlış) değeridir. |
summaryRowSetting |
Bir özet satırının döndürülüp döndürülmeyeceğini belirler. Varsayılan olarak özet satırı döndürülmez. İstenirse diğer tüm sorgu sonuçları döndürüldükten sonra özet satırı tek başına yanıt olarak gönderilir. |
Yanıt gövdesi
SearchAds360Service.Search
için yanıt mesajı.
Başarılı olursa yanıt metni aşağıdaki yapıyla birlikte verileri içerir:
JSON gösterimi |
---|
{ "results": [ { object ( |
Alanlar | |
---|---|
results[] |
Sorguyla eşleşen satırların listesi. |
nextPageToken |
Sonraki sonuç sayfasını almak için kullanılan sayfalandırma jetonu. Bu dizenin içeriğini bir sonraki isteğin |
totalResultsCount |
LIMIT yantümcesi yok sayıldığında sorguyla eşleşen toplam sonuç sayısı. |
fieldMask |
Kullanıcının istediği alanları temsil eden FieldMask. Bu, tam nitelikli alan adlarının virgülle ayrılmış bir listesidir. Örnek: |
summaryRow |
Sonuçlardaki metriklerin özetini içeren özet satırı. Metriklerin özeti, tüm sonuçlardaki metriklerin toplamı anlamına gelir. Burada toplama, toplam, ortalama, oran vb. olabilir. |
customColumnHeaders[] |
Sonuçlardaki özel sütunların başlıkları. |
conversionCustomMetricHeaders[] |
Sonuçlardaki dönüşüm özel metriklerinin başlıkları. |
conversionCustomDimensionHeaders[] |
Sonuçlardaki dönüşüm özel boyutlarının başlıkları. |
rawEventConversionMetricHeaders[] |
Sonuçlardaki ham etkinlik dönüşümü metriklerinin başlıkları. |
rawEventConversionDimensionHeaders[] |
Sonuçlardaki ham etkinlik dönüşümü boyutlarının başlıkları. |
Yetkilendirme kapsamları
Aşağıdaki OAuth kapsamını gerektirir:
https://www.googleapis.com/auth/doubleclicksearch