Google Ads API के v17 वर्शन का एलान

बुधवार, 5 जून, 2024

आज हम Google Ads API के v17 को रिलीज़ करने का एलान कर रहे हैं. v17 की कुछ सुविधाओं का इस्तेमाल करने के लिए, आपको अपनी क्लाइंट लाइब्रेरी और क्लाइंट कोड को अपग्रेड करना होगा. अपडेट की गई क्लाइंट लाइब्रेरी और कोड के उदाहरण अगले हफ़्ते पब्लिश किए जाएंगे.

यहां इसके हाइलाइट देखें:

  • संसाधन के इस्तेमाल से जुड़ी नीति में बदलाव 17 जून, 2024 से लागू होगा. इसकी तैयारी के लिए, हमने QuotaError में दो नई वैल्यू जोड़ी हैं. ये वैल्यू, GoogleAdsService.Search() और GoogleAdsService.SearchStream() अनुरोधों के लिए, किसी क्वेरी पैटर्न के ज़रिए तय समयावधि में संसाधन के बहुत ज़्यादा इस्तेमाल के लिए थ्रो की जाती हैं.
  • page_size फ़ील्ड हमेशा 10,000 पर सेट होता है. अब GoogleAdsService.Search को page_size पास नहीं किया जा सकता. ऐसा करने पर, RequestError.PAGE_SIZE_NOT_SUPPORTED गड़बड़ी होगी.
  • परफ़ॉर्मेंस मैक्स और सर्च कैंपेन की ज़्यादा मेट्रिक रिपोर्ट करने के लिए, campaign_aggregate_asset_view और channel_aggregate_asset_view को जोड़ा गया.
  • बैच प्रोसेसिंग में बदलाव:
    • BatchJobService का इस्तेमाल करते समय, MutateOperation.asset_group_operation को सेट करने की सुविधा जोड़ी गई. इससे आपको बैच प्रोसेसिंग का इस्तेमाल करके, परफ़ॉर्मेंस मैक्स कैंपेन बनाने और उन्हें मैनेज करने की सुविधा मिलती है.
    • 1,04,84,504 बाइट से बड़ी AddBatchJobOperationsRequest सबमिट करने पर, BatchJobError.REQUEST_TOO_LARGE गड़बड़ी का मैसेज जोड़ा गया. आपको कार्रवाइयों को छोटे-छोटे ग्रुप में बांटना चाहिए और उन्हें अलग-अलग अनुरोध के तौर पर भेजना चाहिए.
  • Campaign.keyword_match_type को जोड़ा गया, ताकि कैंपेन में मौजूद सभी कीवर्ड के लिए, कीवर्ड मैच टाइप सेट किया जा सके.
  • Google Ads API में मौजूद अन्य सेवाओं के साथ अलाइन करने के लिए, AdService.getAd को हटा दिया गया है. संसाधनों को फ़ेच करने के तरीके के बारे में सुझाव पाने के लिए, ऑब्जेक्ट वापस पाना लेख पढ़ें.
  • AdGroupCriterion में primary_status और primary_status_reasons को जोड़ा गया, ताकि यह दिखाया जा सके कि विज्ञापन ग्रुप की शर्त पूरी करने वाले विज्ञापन दिख रहे हैं या नहीं. अगर विज्ञापन नहीं दिख रहे हैं, तो इसकी वजह भी बताई जा सके.
  • एक नई रिपोर्ट shopping_product जोड़ी गई है. यह Google Ads के यूज़र इंटरफ़ेस (यूआई) के प्रॉडक्ट पेज से जुड़ी है.
  • डाइमेंशन और फ़ॉर्मैट के बारे में ImageAdInfo.image_asset के लिए ज़्यादा पुष्टि करने के तरीके जोड़े गए हैं. इससे यह Google Ads API में, इमेज की पुष्टि करने के अन्य तरीकों के साथ ज़्यादा बेहतर तरीके से काम करता है.
  • segments.sk_ad_network_redistributed_fine_conversion_value को जोड़ा गया. यह हाल ही के SkAdNetwork पोस्टबैक डेटा पर मशीन लर्निंग मॉडल के आधार पर, NULL वैल्यू को अन्य वैल्यू में फिर से डिस्ट्रिब्यूट करता है.
  • Google Ads API के सभी संसाधनों के सभी फ़ील्ड, enum, और गड़बड़ियों में, डिस्कवरी का नाम बदलकर मांग बढ़ाने में मदद करने वाला कैंपेन कर दिया गया है.
  • product_link के लिए क्वेरी करते समय, अब लिंक किए गए एक प्रॉडक्ट से जुड़े फ़ील्ड ही चुने जा सकते हैं. ऐसा न करने पर, QueryError.PROHIBITED_FIELD_COMBINATION_IN_SELECT_CLAUSE दिखेगा.
  • ऑडियंस के ग्राहक टाइप को कॉन्फ़िगर करने के लिए, UserListCustomerTypeService.MutateUserListCustomerTypes() को जोड़ा गया. इस तरीके से, CustomerLifecycleGoal.lifecycle_goal_customer_definition_settings का इस्तेमाल करने की ज़रूरत नहीं पड़ती.
  • खत्म होने की तारीख और समय (expiration_date_time) के दो फ़ील्ड local_services_verification_artifact जोड़े गए हैं. इससे विज्ञापन देने वाले लोग या कंपनियां, आर्टफ़ैक्ट की समयसीमा खत्म होने की तारीख को बेहतर तरीके से मॉनिटर कर सकती हैं.

मुझे ज़्यादा जानकारी कहां से मिल सकती है?
इन संसाधनों से आपको शुरुआत करने में मदद मिल सकती है:

अगर आपको कुछ पूछना है या कोई मदद चाहिए, तो फ़ोरम के ज़रिए हमसे संपर्क करें.

Labels: google-ads-api, release