कुकबुक की क्वेरी

इस गाइड में Google Ads क्वेरी भाषा की क्वेरी का एक सेट दिया गया है. इससे पता चलता है कि Google Ads यूज़र इंटरफ़ेस (यूआई) में वही डेटा कैसे दिखाया जाए जो स्क्रीन पर दिखता है. साथ ही, जियो कॉन्सटेंट को खोजने का तरीका भी बताया गया है. इन क्वेरी का इस्तेमाल, अपनी पसंद के मुताबिक क्वेरी बनाने के लिए या इसे शुरुआती पॉइंट के तौर पर किया जा सकता है.

ध्यान दें: नई क्वेरी की इंटरैक्टिव तरीके से पुष्टि और प्रोटोटाइप करने के लिए, आपके पास इंटरैक्टिव क्वेरी बिल्डर टूल का इस्तेमाल करने का भी विकल्प है.

अहम जानकारी: नीचे दिए गए cURL टैब, सीधे तौर पर एपीआई के REST इंटरफ़ेस का इस्तेमाल करने के बारे में बताते हैं. ज़्यादा जानकारी के लिए, REST गाइड का search पेज देखें.

Google Ads की यूज़र इंटरफ़ेस (यूआई) स्क्रीन की नकल करना

इस सेक्शन में ऐसी एपीआई क्वेरी दिखती हैं जो Google Ads यूज़र इंटरफ़ेस (यूआई) की डिफ़ॉल्ट स्क्रीन के रूप में ही डेटा दिखाती हैं. अगर कोई ऐसा ऐप्लिकेशन बनाया जा रहा है जो Google Ads की तरह ही मेट्रिक और डेटा दिखाता है, तो इन क्वेरी की मदद से एपीआई से जानकारी वाला डेटा मिल सकता है.

ध्यान दें: जब तक अलग से न बताया जाए, तब तक इस गाइड में दी गई तारीख वाली सभी क्वेरी, डिफ़ॉल्ट रूप से पिछले सात दिनों का डेटा दिखाती हैं.

कैंपेन

यूज़र इंटरफ़ेस (यूआई) में, डिफ़ॉल्ट कैंपेन की खास जानकारी वाली स्क्रीन.

यूज़र इंटरफ़ेस (यूआई) स्क्रीन

एपीआई क्वेरी

जीएक्यूएल

SELECT campaign.name,
  campaign_budget.amount_micros,
  campaign.status,
  campaign.optimization_score,
  campaign.advertising_channel_type,
  metrics.clicks,
  metrics.impressions,
  metrics.ctr,
  metrics.average_cpc,
  metrics.cost_micros,
  campaign.bidding_strategy_type
FROM campaign
WHERE segments.date DURING LAST_7_DAYS
  AND campaign.status != 'REMOVED'

cURL

curl -f --request POST "https://googleads.googleapis.com/v${API_VERSION}/customers/${CUSTOMER_ID}/googleAds:searchStream" \
--header "Content-Type: application/json" \
--header "developer-token: ${DEVELOPER_TOKEN}" \
--header "login-customer-id: ${MANAGER_CUSTOMER_ID}" \
--header "Authorization: Bearer ${OAUTH2_ACCESS_TOKEN}" \
--data '{
"query": "
  SELECT campaign.name,
    campaign_budget.amount_micros,
    campaign.status,
    campaign.optimization_score,
    campaign.advertising_channel_type,
    metrics.clicks,
    metrics.impressions,
    metrics.ctr,
    metrics.average_cpc,
    metrics.cost_micros,
    campaign.bidding_strategy_type
  FROM campaign
  WHERE segments.date DURING LAST_7_DAYS
    AND campaign.status != 'REMOVED'
"
}'

विज्ञापन ग्रुप

यूज़र इंटरफ़ेस (यूआई) में डिफ़ॉल्ट विज्ञापन ग्रुप की खास जानकारी वाली स्क्रीन.

यूज़र इंटरफ़ेस (यूआई) स्क्रीन

एपीआई क्वेरी

जीएक्यूएल

SELECT ad_group.name,
  campaign.name,
  ad_group.status,
  ad_group.type,
  metrics.clicks,
  metrics.impressions,
  metrics.ctr,
  metrics.average_cpc,
  metrics.cost_micros
FROM ad_group
WHERE segments.date DURING LAST_7_DAYS
  AND ad_group.status != 'REMOVED'

cURL

curl -f --request POST "https://googleads.googleapis.com/v${API_VERSION}/customers/${CUSTOMER_ID}/googleAds:searchStream" \
--header "Content-Type: application/json" \
--header "developer-token: ${DEVELOPER_TOKEN}" \
--header "login-customer-id: ${MANAGER_CUSTOMER_ID}" \
--header "Authorization: Bearer ${OAUTH2_ACCESS_TOKEN}" \
--data '{
"query": "
  SELECT ad_group.name,
    campaign.name,
    ad_group.status,
    ad_group.type,
    metrics.clicks,
    metrics.impressions,
    metrics.ctr,
    metrics.average_cpc,
    metrics.cost_micros
  FROM ad_group
  WHERE segments.date DURING LAST_7_DAYS
    AND ad_group.status != 'REMOVED'
"
}'

विज्ञापन

यूज़र इंटरफ़ेस (यूआई) में डिफ़ॉल्ट तौर पर, Google Ads की खास जानकारी वाली स्क्रीन.

ध्यान रखें कि यह क्वेरी खास तौर पर, बड़े किए गए टेक्स्ट विज्ञापन के अलग-अलग कॉम्पोनेंट को फ़ेच करती है. ये कॉम्पोनेंट, यूज़र इंटरफ़ेस (यूआई) स्क्रीन के विज्ञापन कॉलम में एक साथ रेंडर होते हैं.

यूज़र इंटरफ़ेस (यूआई) स्क्रीन

एपीआई क्वेरी

जीएक्यूएल

SELECT ad_group_ad.ad.expanded_text_ad.headline_part1,
  ad_group_ad.ad.expanded_text_ad.headline_part2,
  ad_group_ad.ad.expanded_text_ad.headline_part3,
  ad_group_ad.ad.final_urls,
  ad_group_ad.ad.expanded_text_ad.description,
  ad_group_ad.ad.expanded_text_ad.description2,
  campaign.name,
  ad_group.name,
  ad_group_ad.policy_summary.approval_status,
  ad_group_ad.ad.type,
  metrics.clicks,
  metrics.impressions,
  metrics.ctr,
  metrics.average_cpc,
  metrics.cost_micros
FROM ad_group_ad
WHERE segments.date DURING LAST_7_DAYS
  AND ad_group_ad.status != 'REMOVED'

cURL

curl -f --request POST "https://googleads.googleapis.com/v${API_VERSION}/customers/${CUSTOMER_ID}/googleAds:searchStream" \
--header "Content-Type: application/json" \
--header "developer-token: ${DEVELOPER_TOKEN}" \
--header "login-customer-id: ${MANAGER_CUSTOMER_ID}" \
--header "Authorization: Bearer ${OAUTH2_ACCESS_TOKEN}" \
--data '{
"query": "
  SELECT ad_group_ad.ad.expanded_text_ad.headline_part1,
    ad_group_ad.ad.expanded_text_ad.headline_part2,
    ad_group_ad.ad.expanded_text_ad.headline_part3,
    ad_group_ad.ad.final_urls,
    ad_group_ad.ad.expanded_text_ad.description,
    ad_group_ad.ad.expanded_text_ad.description2,
    campaign.name,
    ad_group.name,
    ad_group_ad.policy_summary.approval_status,
    ad_group_ad.ad.type,
    metrics.clicks,
    metrics.impressions,
    metrics.ctr,
    metrics.average_cpc,
    metrics.cost_micros
  FROM ad_group_ad
  WHERE segments.date DURING LAST_7_DAYS
    AND ad_group_ad.status != 'REMOVED'
"
}'

सर्च कीवर्ड

यूज़र इंटरफ़ेस (यूआई) में, डिफ़ॉल्ट सर्च कीवर्ड की खास जानकारी वाली स्क्रीन.

यूज़र इंटरफ़ेस (यूआई) स्क्रीन

एपीआई क्वेरी

जीएक्यूएल

SELECT ad_group_criterion.keyword.text,
  campaign.name,
  ad_group.name,
  ad_group_criterion.system_serving_status,
  ad_group_criterion.keyword.match_type,
  ad_group_criterion.approval_status,
  ad_group_criterion.final_urls,
  metrics.clicks,
  metrics.impressions,
  metrics.ctr,
  metrics.average_cpc,
  metrics.cost_micros
FROM keyword_view
WHERE segments.date DURING LAST_7_DAYS
  AND ad_group_criterion.status != 'REMOVED'

cURL

curl -f --request POST "https://googleads.googleapis.com/v${API_VERSION}/customers/${CUSTOMER_ID}/googleAds:searchStream" \
--header "Content-Type: application/json" \
--header "developer-token: ${DEVELOPER_TOKEN}" \
--header "login-customer-id: ${MANAGER_CUSTOMER_ID}" \
--header "Authorization: Bearer ${OAUTH2_ACCESS_TOKEN}" \
--data '{
"query": "
  SELECT ad_group_criterion.keyword.text,
    campaign.name,
    ad_group.name,
    ad_group_criterion.system_serving_status,
    ad_group_criterion.keyword.match_type,
    ad_group_criterion.approval_status,
    ad_group_criterion.final_urls,
    metrics.clicks,
    metrics.impressions,
    metrics.ctr,
    metrics.average_cpc,
    metrics.cost_micros
  FROM keyword_view
  WHERE segments.date DURING LAST_7_DAYS
    AND ad_group_criterion.status != 'REMOVED'
"
}'

खोज क्वेरी

यूज़र इंटरफ़ेस (यूआई) में, खोज के लिए इस्तेमाल हुए शब्दों की खास जानकारी देने वाली डिफ़ॉल्ट स्क्रीन.

यूज़र इंटरफ़ेस (यूआई) स्क्रीन

एपीआई क्वेरी

जीएक्यूएल

SELECT search_term_view.search_term,
  segments.keyword.info.match_type,
  search_term_view.status,
  campaign.name,
  ad_group.name,
  metrics.clicks,
  metrics.impressions,
  metrics.ctr,
  metrics.average_cpc,
  metrics.cost_micros,
  campaign.advertising_channel_type
FROM search_term_view
WHERE segments.date DURING LAST_7_DAYS

cURL

curl -f --request POST "https://googleads.googleapis.com/v${API_VERSION}/customers/${CUSTOMER_ID}/googleAds:searchStream" \
--header "Content-Type: application/json" \
--header "developer-token: ${DEVELOPER_TOKEN}" \
--header "login-customer-id: ${MANAGER_CUSTOMER_ID}" \
--header "Authorization: Bearer ${OAUTH2_ACCESS_TOKEN}" \
--data '{
"query": "
  SELECT search_term_view.search_term,
    segments.keyword.info.match_type,
    search_term_view.status,
    campaign.name,
    ad_group.name,
    metrics.clicks,
    metrics.impressions,
    metrics.ctr,
    metrics.average_cpc,
    metrics.cost_micros,
    campaign.advertising_channel_type
  FROM search_term_view
  WHERE segments.date DURING LAST_7_DAYS
"
}'

ऑडियंस

यूज़र इंटरफ़ेस (यूआई) में, डिफ़ॉल्ट ऑडियंस की खास जानकारी वाली स्क्रीन.

ध्यान दें कि Reporting API ऑडियंस को उनके मानदंड आईडी के हिसाब से दिखाता है. उपयोगकर्ताओं के डिसप्ले नेम देखने के लिए, कोड और फ़ॉर्मैट पेज पर दी गई रेफ़रंस टेबल में आईडी देखें. यह तय करने के लिए कि किस मापदंड टाइप टेबल का इस्तेमाल करना है, ad_group_criterion.type फ़ील्ड को बंद किया जा सकता है.

यूज़र इंटरफ़ेस (यूआई) स्क्रीन

एपीआई क्वेरी

जीएक्यूएल

SELECT ad_group_criterion.resource_name,
  ad_group_criterion.type,
  campaign.name,
  ad_group.name,
  ad_group_criterion.system_serving_status,
  ad_group_criterion.bid_modifier,
  metrics.clicks,
  metrics.impressions,
  metrics.ctr,
  metrics.average_cpc,
  metrics.cost_micros,
  campaign.advertising_channel_type
FROM ad_group_audience_view
WHERE segments.date DURING LAST_7_DAYS

cURL

curl -f --request POST "https://googleads.googleapis.com/v${API_VERSION}/customers/${CUSTOMER_ID}/googleAds:searchStream" \
--header "Content-Type: application/json" \
--header "developer-token: ${DEVELOPER_TOKEN}" \
--header "login-customer-id: ${MANAGER_CUSTOMER_ID}" \
--header "Authorization: Bearer ${OAUTH2_ACCESS_TOKEN}" \
--data '{
"query": "
  SELECT ad_group_criterion.resource_name,
    ad_group_criterion.type,
    campaign.name,
    ad_group.name,
    ad_group_criterion.system_serving_status,
    ad_group_criterion.bid_modifier,
    metrics.clicks,
    metrics.impressions,
    metrics.ctr,
    metrics.average_cpc,
    metrics.cost_micros,
    campaign.advertising_channel_type
  FROM ad_group_audience_view
  WHERE segments.date DURING LAST_7_DAYS
"
}'

उम्र (डेमोग्राफ़िक्स)

यूज़र इंटरफ़ेस (यूआई) में, उम्र के हिसाब से डेमोग्राफ़िक्स की खास जानकारी देने वाली डिफ़ॉल्ट स्क्रीन.

यूज़र इंटरफ़ेस (यूआई) स्क्रीन

एपीआई क्वेरी

जीएक्यूएल

SELECT ad_group_criterion.age_range.type,
  campaign.name,
  ad_group.name,
  ad_group_criterion.system_serving_status,
  ad_group_criterion.bid_modifier,
  metrics.clicks,
  metrics.impressions,
  metrics.ctr,
  metrics.average_cpc,
  metrics.cost_micros,
  campaign.advertising_channel_type
FROM age_range_view
WHERE segments.date DURING LAST_7_DAYS

cURL

curl -f --request POST "https://googleads.googleapis.com/v${API_VERSION}/customers/${CUSTOMER_ID}/googleAds:searchStream" \
--header "Content-Type: application/json" \
--header "developer-token: ${DEVELOPER_TOKEN}" \
--header "login-customer-id: ${MANAGER_CUSTOMER_ID}" \
--header "Authorization: Bearer ${OAUTH2_ACCESS_TOKEN}" \
--data '{
"query": "
  SELECT ad_group_criterion.age_range.type,
    campaign.name,
    ad_group.name,
    ad_group_criterion.system_serving_status,
    ad_group_criterion.bid_modifier,
    metrics.clicks,
    metrics.impressions,
    metrics.ctr,
    metrics.average_cpc,
    metrics.cost_micros,
    campaign.advertising_channel_type
  FROM age_range_view
  WHERE segments.date DURING LAST_7_DAYS
"
}'

लिंग (डेमोग्राफ़िक्स)

यूज़र इंटरफ़ेस (यूआई) में, लिंग की डेमोग्राफ़िक्स की खास जानकारी देने वाली डिफ़ॉल्ट स्क्रीन.

यूज़र इंटरफ़ेस (यूआई) स्क्रीन

एपीआई क्वेरी

जीएक्यूएल

SELECT ad_group_criterion.gender.type,
  campaign.name,
  ad_group.name,
  ad_group_criterion.system_serving_status,
  ad_group_criterion.bid_modifier,
  metrics.clicks,
  metrics.impressions,
  metrics.ctr,
  metrics.average_cpc,
  metrics.cost_micros,
  campaign.advertising_channel_type
FROM gender_view
WHERE segments.date DURING LAST_7_DAYS

cURL

curl -f --request POST "https://googleads.googleapis.com/v${API_VERSION}/customers/${CUSTOMER_ID}/googleAds:searchStream" \
--header "Content-Type: application/json" \
--header "developer-token: ${DEVELOPER_TOKEN}" \
--header "login-customer-id: ${MANAGER_CUSTOMER_ID}" \
--header "Authorization: Bearer ${OAUTH2_ACCESS_TOKEN}" \
--data '{
"query": "
  SELECT ad_group_criterion.gender.type,
    campaign.name,
    ad_group.name,
    ad_group_criterion.system_serving_status,
    ad_group_criterion.bid_modifier,
    metrics.clicks,
    metrics.impressions,
    metrics.ctr,
    metrics.average_cpc,
    metrics.cost_micros,
    campaign.advertising_channel_type
  FROM gender_view
  WHERE segments.date DURING LAST_7_DAYS
"
}'

देश या इलाके

यूज़र इंटरफ़ेस (यूआई) में, जगहों की खास जानकारी वाली डिफ़ॉल्ट स्क्रीन.

ध्यान दें कि Reporting API, जगह की जानकारी को शर्त के आईडी के हिसाब से दिखाता है. उनके डिसप्ले नेम देखने के लिए, जियो टारगेट डेटा में campaign_criterion.location.geo_target_constant देखें या geo_target_constant संसाधन के बारे में क्वेरी करने के लिए एपीआई का इस्तेमाल करें.

यूज़र इंटरफ़ेस (यूआई) स्क्रीन

एपीआई क्वेरी

जीएक्यूएल

SELECT campaign_criterion.location.geo_target_constant,
  campaign.name,
  campaign_criterion.bid_modifier,
  metrics.clicks,
  metrics.impressions,
  metrics.ctr,
  metrics.average_cpc,
  metrics.cost_micros
FROM location_view
WHERE segments.date DURING LAST_7_DAYS
  AND campaign_criterion.status != 'REMOVED'

cURL

curl -f --request POST "https://googleads.googleapis.com/v${API_VERSION}/customers/${CUSTOMER_ID}/googleAds:searchStream" \
--header "Content-Type: application/json" \
--header "developer-token: ${DEVELOPER_TOKEN}" \
--header "login-customer-id: ${MANAGER_CUSTOMER_ID}" \
--header "Authorization: Bearer ${OAUTH2_ACCESS_TOKEN}" \
--data '{
"query": "
  SELECT campaign_criterion.location.geo_target_constant,
    campaign.name,
    campaign_criterion.bid_modifier,
    metrics.clicks,
    metrics.impressions,
    metrics.ctr,
    metrics.average_cpc,
    metrics.cost_micros
  FROM location_view
  WHERE segments.date DURING LAST_7_DAYS
    AND campaign_criterion.status != 'REMOVED'
"
}'

भौगोलिक स्थिरांक खोजे जा रहे हैं

कोड और फ़ॉर्मैट पेज पर, एपीआई में इस्तेमाल किए जाने वाले ज़्यादातर कॉन्सटेंट के लिए रेफ़रंस टेबल दी जाती है. हालांकि, Google Ads क्वेरी लैंग्वेज का इस्तेमाल करके, डाइनैमिक तौर पर कुछ कॉन्सटेंट भी देखे जा सकते हैं.

इस सैंपल में, किसी जगह को संसाधन के नाम या डिसप्ले नेम से खोजने का तरीका बताया गया है.

संसाधन के नाम के हिसाब से

Mountain View, CA को उसके संसाधन नाम geoTargetConstants/1014044 से खोजें.

जीएक्यूएल

SELECT geo_target_constant.canonical_name,
  geo_target_constant.country_code,
  geo_target_constant.id,
  geo_target_constant.name,
  geo_target_constant.status,
  geo_target_constant.target_type
FROM geo_target_constant
WHERE geo_target_constant.resource_name = 'geoTargetConstants/1014044'

cURL

curl -f --request POST "https://googleads.googleapis.com/v${API_VERSION}/customers/${CUSTOMER_ID}/googleAds:searchStream" \
--header "Content-Type: application/json" \
--header "developer-token: ${DEVELOPER_TOKEN}" \
--header "login-customer-id: ${MANAGER_CUSTOMER_ID}" \
--header "Authorization: Bearer ${OAUTH2_ACCESS_TOKEN}" \
--data "{
\"query\": \"
  SELECT geo_target_constant.canonical_name,
    geo_target_constant.country_code,
    geo_target_constant.id,
    geo_target_constant.name,
    geo_target_constant.status,
    geo_target_constant.target_type
  FROM geo_target_constant
  WHERE geo_target_constant.resource_name = 'geoTargetConstants/1014044'
\"
}"

डिसप्ले नेम के मुताबिक

अमेरिका में "माउंटेन व्यू" को शहर के नाम के तौर पर खोजें.

ध्यान दें: नाम के हिसाब से जगहों के बारे में क्वेरी करने पर, आपको कई मैच मिल सकते हैं. पक्का करें कि आपके क्लाइंट कोड में, नतीजों की सूची को सही तरह से बांटा गया हो.

जीएक्यूएल

SELECT geo_target_constant.canonical_name,
  geo_target_constant.country_code,
  geo_target_constant.id,
  geo_target_constant.name,
  geo_target_constant.status,
  geo_target_constant.target_type
FROM geo_target_constant
WHERE geo_target_constant.country_code = 'US'
  AND geo_target_constant.target_type = 'City'
  AND geo_target_constant.name = 'Mountain View'
  AND geo_target_constant.status = 'ENABLED'

cURL

curl -f --request POST "https://googleads.googleapis.com/v${API_VERSION}/customers/${CUSTOMER_ID}/googleAds:searchStream" \
--header "Content-Type: application/json" \
--header "developer-token: ${DEVELOPER_TOKEN}" \
--header "login-customer-id: ${MANAGER_CUSTOMER_ID}" \
--header "Authorization: Bearer ${OAUTH2_ACCESS_TOKEN}" \
--data "{
\"query\": \"
  SELECT geo_target_constant.canonical_name,
    geo_target_constant.country_code,
    geo_target_constant.id,
    geo_target_constant.name,
    geo_target_constant.status,
    geo_target_constant.target_type
  FROM geo_target_constant
  WHERE geo_target_constant.country_code = 'US'
    AND geo_target_constant.target_type = 'City'
    AND geo_target_constant.name = 'Mountain View'
    AND geo_target_constant.status = 'ENABLED'
\"
}"