क्वेरी का स्ट्रक्चर

संसाधन, सेगमेंट, और मेट्रिक फ़ील्ड के लिए क्वेरी यहां भेजी जा सकती हैं: GoogleAdsService खोजें या SearchStream तरीकों का इस्तेमाल करना होगा. Google Ads क्वेरी लैंग्वेज में क्वेरी बनाने के लिए, आपको इसका इस्तेमाल करके क्वेरी बनानी होगी भाषा का व्याकरण शामिल करें. क्वेरी में कई चीज़ें शामिल होती हैं क्लॉज़:

• SELECT
• FROM
• WHERE
• ORDER BY
• LIMIT
• PARAMETERS

क्लॉज़ में फ़ील्ड के नाम, रिसॉर्स के नाम, ऑपरेटर, शर्तें, और क्रम सबमिट करें, ताकि आपको सही डेटा चुनने में मदद मिल सके. एक बार में मर्ज हो जाने पर क्वेरी है, तो Google Ads API का इस्तेमाल करके अनुरोध किया जा सकता है.

अहम जानकारी: GoogleAdsFieldService इससे Google Ads की क्वेरी लैंग्वेज के क्लाइंट को कैटलॉग मिलता है. इसमें सभी संसाधनों का मेटाडेटा भी दिया जाता है फ़ील्ड, सेगमेंट फ़ील्ड, और मेट्रिक. साथ ही, हर एक फ़ील्ड से उनका संबंध और उनकी उपलब्धता के बारे में नीचे बताया गया है. ज़्यादा जानकारी के लिए, GoogleAdsField का दस्तावेज़ देखें.

उपनियम

अभी तक किसी भी व्यक्ति ने चेक इन नहीं किया है वीडियो: GAQL फ़ील्ड संगतता

चुनें

SELECT क्लॉज़, अनुरोध में फ़ेच किए जाने वाले फ़ील्ड के सेट के बारे में बताता है. SELECT, संसाधन फ़ील्ड, सेगमेंट फ़ील्ड की कॉमा-सेपरेटेड लिस्ट लेता है. और मेट्रिक, रिस्पॉन्स में वैल्यू दिखाता है. SELECT क्लॉज़ यह है क्वेरी में ज़रूरी है.

नीचे दी गई सैंपल क्वेरी में, दिए गए एट्रिब्यूट के लिए एट्रिब्यूट चुनने का एक उदाहरण दिया गया है संसाधन:

SELECT
  campaign.id,
  campaign.name
FROM campaign

एक ही अनुरोध में अलग-अलग तरह के फ़ील्ड के लिए अनुरोध किया जा सकता है. उदाहरण के लिए:

SELECT
  campaign.id,
  campaign.name,
  bidding_strategy.id,
  bidding_strategy.name,
  segments.device,
  segments.date,
  metrics.impressions,
  metrics.clicks
FROM campaign
WHERE segments.date DURING LAST_30_DAYS

• संसाधन फ़ील्ड

  • campaign.id
  • campaign.name

• संसाधन फ़ील्ड

  • bidding_strategy.id
  • bidding_strategy.name

• सेगमेंट वाले फ़ील्ड

  • segments.device
  • segments.date

• मेट्रिक

  • metrics.impressions
  • metrics.clicks

SELECT क्लॉज़ में कुछ फ़ील्ड को शामिल करने की अनुमति नहीं दी जा सकती. ऐसा इन वजहों से हो सकता है प्रतिबंध:

• ऐसे फ़ील्ड के बारे में क्वेरी की जा रही है जिन्हें चुना नहीं जा सकता. इन फ़ील्ड का Selectable मेटाडेटा एट्रिब्यूट को false के तौर पर मार्क किया गया है.
• दोहराए गए फ़ील्ड के एट्रिब्यूट चुनना. इन फ़ील्ड का isRepeated मेटाडेटा एट्रिब्यूट को true के तौर पर मार्क किया गया है.
• वे फ़ील्ड चुने जा रहे हैं जो FROM में दिए गए संसाधन के लिए उपलब्ध नहीं हैं क्लॉज़. कुछ संसाधनों की विशेषताओं को एक साथ नहीं चुना जा सकता. ऐसा सिर्फ़ एक सभी मेट्रिक और सेगमेंट का सबसेट FROM क्लॉज़.
• ऐसे सेगमेंट या मेट्रिक चुनना जो एक-दूसरे के साथ काम नहीं करते. इसके लिए इस बारे में ज़्यादा जानकारी पाने के लिए, सेगमेंटेशन सेक्शन.

ऊपर दी गई स्थितियों से जुड़ी जानकारी, हमारे रेफ़रंस दस्तावेज़ों में मिल सकती है या GoogleAdsFieldService से.

FROM

FROM क्लॉज़ मुख्य रिसॉर्स के बारे में बताता है जिसे दिखाया जाएगा. कॉन्टेंट बनाने FROM क्लॉज़ में मौजूद संसाधन से यह पता चलता है कि कौनसे फ़ील्ड का इस्तेमाल किया जा सकता है दी गई क्वेरी के लिए क्लॉज़. इसमें सिर्फ़ एक संसाधन तय किया जा सकता है FROM क्लॉज़. इस क्वेरी में FROM क्लॉज़ ज़रूरी है GoogleAdsService खोजें या SearchStream तरीकों की जानकारी देनी होगी. हालांकि, इसका इस्तेमाल करते समय इसे नहीं बताया जाना चाहिए GoogleAdsFieldService.

किसी क्वेरी के लिए, FROM क्लॉज़ में सिर्फ़ एक रिसॉर्स मौजूद हो सकता है, लेकिन फ़ील्ड एट्रिब्यूट किए गए संसाधन से भी उपलब्ध हो सकते हैं. ये संसाधन हैं: FROM क्लॉज़ में रिसॉर्स के साथ साफ़ तौर पर जोड़ा गया हो, इसलिए आपको सिर्फ़ उनकी वैल्यू दिखाने के लिए, SELECT क्लॉज़ में एट्रिब्यूट जोड़ें. ऐसा हो सकता है कि सभी पक्षों को संसाधनों में एट्रिब्यूट किए गए संसाधन हैं. नीचे दिए गए उदाहरण में, आपके पास विज्ञापन ग्रुप का आईडी और कैंपेन आईडी, दोनों:

SELECT
  campaign.id,
  ad_group.id
FROM ad_group

मुख्य संसाधन का resource_name फ़ील्ड हमेशा दिखाया जाता है. यहां दिए गए उदाहरण में, ad_group.resource_name को क्वेरी में साफ़ तौर पर नहीं चुने जाने के बावजूद यह रिस्पॉन्स दें:

SELECT ad_group.id
FROM ad_group

यही बात अन्य संसाधनों पर भी लागू होती है, जब कम से कम एक फ़ील्ड चुनी जाती है. उदाहरण के लिए: campaign.resource_name को निम्न क्वेरी:

SELECT
  campaign.id,
  ad_group.id
FROM ad_group

अहम जानकारी: अगर FROM क्लॉज़ में मौजूद संसाधन, segment तो उस संसाधन का कोई भी एट्रिब्यूट चुना जा सकता है. यह सेगमेंट के तौर पर काम करेगा.

WHERE

WHERE क्लॉज़ में उन शर्तों के बारे में बताया गया है जिन्हें आपको अनुरोध. WHERE क्लॉज़ का इस्तेमाल करते समय, एक या उससे ज़्यादा शर्तें तय की जा सकती हैं इन्हें अलग करने के लिए, AND का इस्तेमाल करें. हर शर्त, पैटर्न के हिसाब से होनी चाहिए field_name Operator value. क्वेरी में WHERE क्लॉज़ का इस्तेमाल करना ज़रूरी नहीं है.

यहां दिए गए उदाहरण में, किसी दिए गए समय की मेट्रिक दिखाने के लिए, WHERE का इस्तेमाल करने का उदाहरण दिया गया है अवधि:

SELECT
  campaign.id,
  campaign.name,
  metrics.impressions
FROM campaign
WHERE segments.date DURING LAST_30_DAYS

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

SELECT
  campaign.id,
  campaign.name,
  segments.device,
  metrics.clicks
FROM campaign
WHERE metrics.impressions > 0
  AND segments.device = MOBILE
  AND segments.date DURING LAST_30_DAYS

WHERE क्लॉज़ के सेगमेंट, SELECT क्लॉज़ में होने चाहिए. साथ ही, उनकी वैल्यू के साथ तारीख के मुख्य सेगमेंट, जिन्हें तारीख के मुख्य सेगमेंट भी कहा जाता है, अपवाद:

• segments.date
• segments.week
• segments.month
• segments.quarter
• segments.year

नीचे दी गई क्वेरी में, ध्यान दें कि segments.date को चुना गया है. यह सेगमेंट तारीख का मुख्य सेगमेंट है, इसलिए इसे सीमित तारीख की ज़रूरत होती है दी जाने वाली WHERE क्लॉज़ में तारीख के मुख्य सेगमेंट वाली सीमा.

SELECT
  campaign.id,
  campaign.name,
  segments.date,
  metrics.clicks
FROM campaign
WHERE segments.date DURING LAST_30_DAYS

ऊपर दी गई शर्त को पूरा करने वाले सभी सेगमेंट ये हैं: segment.date, segment.week, segment.month, segments.quarter, और segment.year के लिए इस्तेमाल कर सकते हैं. अगर इनमें से कोई भी सेगमेंट चुने गए हैं, तो इनमें से कम से कम एक का इस्तेमाल WHERE क्लॉज़ में किया जाना चाहिए.

अहम जानकारी: सेपरेटर AND का इस्तेमाल, ऑपरेटर की शर्तों के बीच ही किया जा सकता है (WHERE segments.device != "DESKTOP" AND segments.device != "MOBILE") और नहीं एक ऑपरेटर शर्त के अंदर (WHERE segments.device != "DESKTOP" AND "MOBILE"),

फ़िल्टर करते समय, ऑपरेटर की केस-सेंसिटिविटी (बड़े और छोटे अक्षरों में अंतर) का ध्यान रखना ज़रूरी है दिमाग. ज़्यादा जानकारी के लिए, केस सेंसिटिविटी देखें.

ऑपरेटर की पूरी सूची के लिए, भाषा व्याकरण शामिल करें.

ORDER BY

ORDER BY क्लॉज़ में नतीजों का क्रम तय होता है वापस किया गया. इससे आपको डेटा को बढ़ते या घटते क्रम में लगाने में मदद मिलती है फ़ील्ड के नाम से तय होता है. हर ऑर्डर को field_name के तौर पर तय किया जाता है. इसके बाद, इसके बाद दिया जाता है ASC या DESC. अगर ASC या DESC, दोनों में से कोई भी तय नहीं है, तो ऑर्डर डिफ़ॉल्ट होता है ASC तक. क्वेरी में ORDER BY क्लॉज़ का इस्तेमाल करना ज़रूरी नहीं है.

यह क्वेरी, लौटाए गए कैंपेन को इन कैंपेन से मिले क्लिक की संख्या के हिसाब से क्रम में लगाती है सबसे ज़्यादा से सबसे कम:

SELECT
  campaign.name,
  metrics.clicks
FROM campaign
ORDER BY metrics.clicks DESC

ORDER BY क्लॉज़ में एक से ज़्यादा फ़ील्ड शामिल किए जा सकते हैं. इसके लिए, कॉमा लगाकर अलग करें सूची. यह क्रम उसी क्रम में होगा जैसा क्वेरी में बताया गया है. उदाहरण के लिए, विज्ञापन ग्रुप का डेटा चुनने वाली इस क्वेरी में, नतीजों को क्रम से लगाया जाएगा कैंपेन के नाम के हिसाब से बढ़ते क्रम में, फिर कैंपेन के नाम के हिसाब से घटते क्रम में इंप्रेशन का प्रतिशत, फिर क्लिक की संख्या के हिसाब से घटते क्रम में:

SELECT
  campaign.name,
  ad_group.name,
  metrics.impressions,
  metrics.clicks
FROM ad_group
ORDER BY
  campaign.name,
  metrics.impressions DESC,
  metrics.clicks DESC

LIMIT

LIMIT क्लॉज़ में, दिए जाने वाले नतीजों की संख्या तय की जा सकती है. यह तब फ़ायदेमंद होता है, जब आपको सिर्फ़ जवाब में दिलचस्पी हो.

उदाहरण के लिए, LIMIT का इस्तेमाल निम्न क्वेरी:

SELECT
  campaign.name,
  ad_group.name,
  segments.device,
  metrics.impressions
FROM ad_group
ORDER BY metrics.impressions DESC
LIMIT 50

अहम जानकारी: LIMIT की मदद से, नतीजों को छोटा किया जा सकता है. page_size फ़ील्ड का इस्तेमाल करना कुल GoogleAdsService.Search मेट्रिक में से नतीजों की लंबी सूचियों को हैंडल करें.

पैरामीटर

PARAMETERS क्लॉज़ की मदद से, अनुरोध के लिए मेटा पैरामीटर तय किए जा सकते हैं. इन पैरामीटर से इस बात पर असर पड़ सकता है कि किस तरह की लाइनें दिखाई जाती हैं.

फ़िलहाल, ये मेटा पैरामीटर इस्तेमाल किए जा सकते हैं:

include_drafts

ड्राफ़्ट इकाइयों को वापस भेजने के लिए, include_drafts को true पर सेट करें. डिफ़ॉल्ट तौर पर, यह false पर सेट होता है.

उदाहरण के लिए, नीचे दी गई क्वेरी, सामान्य कैंपेन के साथ ड्राफ़्ट कैंपेन को फ़ेच करती है अभियान:

SELECT campaign.name
FROM campaign
PARAMETERS include_drafts=true

omit_unselected_resource_names

इसके संसाधन का नाम रोकने के लिए, omit_unselected_resource_names को true पर सेट करें रिस्पॉन्स में हर तरह के संसाधन को तब तक दिखाए जाने से रोका जाता है, जब तक कि साफ़ तौर पर अनुरोध न किया जाए SELECT क्लॉज़ में रखें. डिफ़ॉल्ट तौर पर, यह false पर सेट होता है.

ध्यान दें: अगर आपको, लौटाए गए किसी भी ऑब्जेक्ट को अपडेट करने या हटाने के लिए इस्तेमाल करना है कार्रवाइयां हैं, तो हमारा सुझाव है कि इस विकल्प को तब से false पर सेट करें बिना संसाधन नाम वाले संसाधनों का इस्तेमाल बदलाव करने की कार्रवाइयों में नहीं किया जा सकता. अगर आपने सेट किया है, तो इस विकल्प को true करने के लिए, पक्का करें कि आप दोनों के संसाधन नामों का साफ़ तौर पर अनुरोध करें प्राइमरी रिसॉर्स और क्वेरी का इस्तेमाल करके फ़ेच किए गए एट्रिब्यूट रिसॉर्स.

Delete_unselected_resource_names के उदाहरण
SELECT campaign.name, customer.id FROM campaign	Returned resources: campaign.resource_name customer.resource_name omit_unselected_resource_names डिफ़ॉल्ट रूप से false पर सेट हो जाता है, इसलिए सभीResource_name फ़ील्ड दिखाए जाते हैं.
SELECT campaign.name, customer.id FROM campaign PARAMETERS omit_unselected_resource_names = true	Returned resources: कोई नहीं. अभी तक किसी भी व्यक्ति ने चेक इन नहीं किया है omit_unselected_resource_names की जानकारी true के तौर पर दी गई है और campaign.resource_name और customer.resource_name SELECT क्लॉज़ का हिस्सा नहीं हैं.
SELECT campaign.name, campaign.resource_name FROM campaign PARAMETERS omit_unselected_resource_names = true	Returned resource: campaign.resource_name omit_unselected_resource_names को true के तौर पर दिखाया गया है और campaign.resource_name ने SELECT क्लॉज़.

भाषा के अतिरिक्त नियम

हर क्लॉज़ के उदाहरणों के अलावा, Google Ads Query Language में ये चीज़ें होती हैं इन तरीकों का इस्तेमाल किया जा सकता है:

• मुख्य संसाधन फ़ील्ड को SELECT में शामिल करने के लिए, यह ज़रूरी नहीं है क्लॉज़ तय करें. उदाहरण के लिए, हो सकता है कि आप सिर्फ़ एक या अधिक मुख्य डेटा फ़िल्टर करने के लिए संसाधन फ़ील्ड:

  SELECT campaign.id
  FROM ad_group
  WHERE ad_group.status = PAUSED
  

• मेट्रिक को किसी दिए गए संसाधन के लिए खास तौर पर चुना जा सकता है; कोई और फ़ील्ड नहीं है जो संसाधन चाहिए उनके लिए क्वेरी में ये ज़रूरी हैं:

  SELECT
    metrics.impressions,
    metrics.clicks,
    metrics.cost_micros
  FROM campaign
  

• सेगमेंटेशन फ़ील्ड को, संसाधन फ़ील्ड के बिना चुना जा सकता है या मेट्रिक:

  SELECT segments.device FROM campaign
  

• resource_name फ़ील्ड (उदाहरण के लिए, campaign.resource_name) इसका इस्तेमाल डेटा को फ़िल्टर या ऑर्डर करने के लिए किया जाता है:

  SELECT
    campaign.id,
    campaign.name
  FROM campaign
  WHERE campaign.resource_name = 'customers/1234567/campaigns/987654'