रिलीज नोट्स

इस पेज पर, AdSense Management API के रिलीज़ नोट दिए गए हैं.

वर्शन 2

इस वर्शन में, काम न करने वाले फ़ंक्शन को हटाने और AdSense मैनेजमेंट एपीआई को Google API के मौजूदा स्टैंडर्ड के साथ अलाइन करने के लिए, ये बदलाव किए गए हैं. Google API के वर्शन के लिए बनी योजना के मुताबिक, इस वर्शन को समय-समय पर अपडेट किया जाएगा. इससे, नई सुविधाओं को अलग-अलग मामूली वर्शन में रिलीज़ करने के बजाय, अतिरिक्त (पुराने सिस्टम के साथ काम करने वाली) सुविधाएं शामिल की जा सकेंगी.

2025-02-24

PolicyIssues

• policyTopics[].type फ़ील्ड जोड़ा गया है, ताकि यह पता लगाया जा सके कि नीति का कोई विषय नीति के उल्लंघन से जुड़ी समस्या, कानून का पालन न करने से जुड़ी समस्या या विज्ञापन देने वाले व्यक्ति या कंपनी की प्राथमिकता से जुड़ा है या नहीं. यह policyTopics[].must_fix की जगह ले लेता है, जिसे अब 'अब काम नहीं करता' फ़ील्ड के तौर पर मार्क किया गया है.

2024-04-03

PolicyIssues

• किसी खाते के लिए, नीति के मौजूदा उल्लंघनों और चेतावनियों की रिपोर्ट करने के लिए नया कलेक्शन जोड़ा गया है.

2023-06-19

पेमेंट की पुष्टि के लिए

• payments.list अब प्रीमियम पब्लिशर के पेमेंट की जानकारी दिखाता है.

2023-06-13

रिपोर्ट

• FUNNEL_REQUESTS, FUNNEL_IMPRESSIONS, FUNNEL_CLICKS, और FUNNEL_RPM मेट्रिक जोड़ी गई हैं. इनसे, विज्ञापन यूनिट के अलावा अन्य यूनिट की परफ़ॉर्मेंस के बारे में जानकारी मिलती है. उदाहरण के लिए, मिलती-जुलती खोज यूनिट.

2023-03-30

रिपोर्ट

• PAGE_URL डाइमेंशन जोड़ा गया है. इसकी मदद से, मेट्रिक को पेज के यूआरएल के हिसाब से बांटा जा सकता है. हालांकि, कुछ बातों का ध्यान रखना ज़रूरी है. ज़्यादा जानकारी के लिए, पेज के यूआरएल का ब्रेकडाउन देखें.

2022-09-21

AdUnits

• 'बनाएं' और 'पैच करें' तरीके जोड़े गए. ध्यान दें कि इन तरीकों का इस्तेमाल सिर्फ़ उन प्रोजेक्ट के लिए किया जा सकता है जिन्हें AdSense for Platforms प्रॉडक्ट के लिए चालू किया गया है.

CustomChannels

• बनाने, पैच करने, और अपडेट करने के तरीके जोड़े गए. ध्यान दें कि इन तरीकों का इस्तेमाल सिर्फ़ उन प्रोजेक्ट के लिए किया जा सकता है जिन्हें AdSense for Platforms प्रॉडक्ट के लिए चालू किया गया है.
• संसाधन में 'चालू है' फ़ील्ड जोड़ा गया.

खाते

• getAdBlockingRecoveryTag तरीका जोड़ा गया.

2022-08-25

रिपोर्ट

• HOSTED_AD_CLIENT_ID डाइमेंशन जोड़ा गया है. इसकी मदद से, होस्ट और प्लैटफ़ॉर्म पब्लिशर, अपने पब्लिशर खातों (होस्ट पब्लिशर) और सब-खातों (प्लैटफ़ॉर्म पब्लिशर) के हिसाब से मेट्रिक को बांट सकते हैं.

2022-05-03

AdClient

• get तरीका जोड़ा गया.

रिपोर्ट

• getSaved तरीका जोड़ा गया.

UrlChannels

• get तरीका जोड़ा गया.

2022-03-31

खाता

• एपीआई अब बंद खातों की जानकारी देता है. साथ ही, state फ़ील्ड में खाते की स्थिति के बारे में जानकारी दी जाती है.

AdClient

• ऊपर बताए गए खाते में हुए बदलावों की तरह ही, एपीआई अब ऐसे विज्ञापन क्लाइंट दिखाता है जो इस्तेमाल में नहीं हैं. साथ ही, state फ़ील्ड में विज्ञापन क्लाइंट की स्थिति के बारे में जानकारी दी जाती है.

2022-02-24

Payment

• संसाधन के नाम के फ़ॉर्मैट को बढ़ाया गया है, ताकि YouTube से हुई कमाई के लिए अलग-अलग संसाधनों का इस्तेमाल किया जा सके. यह बदलाव, YouTube क्रिएटर्स के लिए AdSense के बेहतर वर्शन को अलग-अलग चरणों में रोल आउट करने से पहले किया जा रहा है. इस वर्शन में, YouTube से होने वाली कमाई को अलग से अपने पेमेंट्स खाते में भेजा जाएगा. YouTube से होने वाली कमाई के लिए अलग से एक पेमेंट्स खाता बन जाने के बाद, पेमेंट की सूची में YouTube से मिलने वाले पेमेंट की जानकारी भी दिखेगी. YouTube से होने वाली आय के लिए, संसाधन के नाम का यह फ़ॉर्मैट इस्तेमाल किया जाएगा:
  • accounts/{account}/payments/youtube-unpaid, इससे आपको YouTube से होने वाली ऐसी कमाई के बारे में पता चलता है जिसका पेमेंट अब तक नहीं किया गया है.
  • YouTube पर पैसे चुकाकर ली गई सदस्यताओं से हुई कमाई के लिए, accounts/{account}/payments/youtube-yyyy-MM-dd.
  
  ध्यान दें: AdSense से होने वाली आय के लिए, संसाधन के नाम में कोई बदलाव नहीं किया गया है:
  • AdSense से हुई मौजूदा कमाई के लिए, accounts/{account}/payments/unpaid.
  • AdSense से हुई कमाई के लिए, accounts/{account}/payments/yyyy-MM-dd.

2021-06-30

शिकायत करें

• डाइमेंशन AD_FORMAT_NAME और AD_FORMAT_CODE जोड़े गए. इनसे पता चलता है कि उपयोगकर्ताओं को आपकी साइट पर, किस तरह से कोई विज्ञापन दिखाया गया (इन-पेज, विनेट वगैरह). ध्यान दें कि v1.4 में, एक ही नाम वाले, लेकिन अलग-अलग सदस्यों वाले डाइमेंशन (अब इस्तेमाल नहीं किए जाते) थे. v2 में जोड़े गए दो डाइमेंशन, v1.4 में मौजूद डाइमेंशन से अलग हैं.

19-04-2021 (शुरुआती रिलीज़)

सामान्य

• v1.4 में, इस्तेमाल नहीं किए जा सकने वाले सभी तरीके हटा दिए गए हैं. इसमें संसाधन के ऐसे तरीकों को शामिल किया गया है जिनके लिए accountId की ज़रूरत नहीं थी. v2 में, accountId को parent फ़ील्ड में बताया गया है.
• Google API के स्टैंडर्ड के मुताबिक, संसाधनों की पहचान अब name फ़ील्ड से की जाती है. उदाहरण के लिए, AdClient का नाम ऐसा दिखेगा accounts/{accountId}/adclients/{adClientId}. इसके अलावा, v1.4 में रिसॉर्स आईडी का इस्तेमाल रिपोर्टिंग डाइमेंशन के तौर पर किया गया था. हालांकि, v2 में यह वैल्यू अब कई रिसॉर्स पर reporting_dimension_id फ़ील्ड के ज़रिए उपलब्ध है.
• kind फ़ील्ड को सभी संसाधनों से हटा दिया गया है.

खाता

• name फ़ील्ड को बदलकर display_name कर दिया गया है.
• timezone फ़ील्ड को स्ट्रिंग से बदलकर google.type.TimeZone कर दिया गया है.
• creation_time फ़ील्ड (टाइप int64) को बदलकर create_time (टाइप google.protobuf.Timestamp) कर दिया गया है.
• pending_tasks फ़ील्ड जोड़ा गया है. यह उन टास्क की सूची है जिन्हें नए खाते के लिए साइन अप करने की प्रोसेस के तहत पूरा करना ज़रूरी है. उदाहरण के लिए, टास्क आपकी बिलिंग प्रोफ़ाइल या फ़ोन नंबर की पुष्टि से जुड़े हो सकते हैं.
• sub_accounts फ़ील्ड को हटा दिया गया है. listChildAccounts कस्टम तरीके का इस्तेमाल करके, वर्शन 2 में भी यही सुविधा मिल सकती है. listChildAccounts को बार-बार कॉल करके, v2 में चाइल्ड खाते का पूरा ट्री जनरेट किया जा सकता है.

AdClient

• arc_opt_in फ़ील्ड को हटा दिया गया है, क्योंकि इसे AdSense यूज़र इंटरफ़ेस से पहले ही हटा दिया गया है.
• supports_reporting फ़ील्ड को reporting_dimension_id फ़ील्ड से बदल दिया जाता है. यह AD_CLIENT_ID रिपोर्टिंग डाइमेंशन में इस्तेमाल किए गए विज्ञापन क्लाइंट के यूनीक आईडी को दिखाता है. अगर reporting_dimension_id खाली है, तो इसका मतलब है कि AdClient, रिपोर्टिंग के साथ काम नहीं करता.

AdUnit

• status फ़ील्ड का नाम बदलकर state कर दिया गया है. साथ ही, ACTIVE स्टेटस से अब यह पता नहीं चलता कि पिछले सात दिनों में इस विज्ञापन यूनिट पर कोई गतिविधि हुई है या नहीं. v2 में, इसका मतलब है कि उपयोगकर्ता ने विज्ञापन यूनिट को चालू किया है और उस पर विज्ञापन दिखाए जा सकते हैं.
• code फ़ील्ड को हटा दिया गया है. यह वैल्यू अब भी name फ़ील्ड के आखिर में (आखिरी फ़ॉरवर्ड स्लैश के बाद) देखी जा सकती है.
• contentAdsSettings.backupOption फ़ील्ड को हटा दिया गया है.
• type फ़ील्ड में सिर्फ़ ये वैल्यू डाली जा सकती हैं: TYPE_UNSPECIFIED, DISPLAY, FEED, ARTICLE, MATCHED_CONTENT, और LINK.
• AdSense के यूज़र इंटरफ़ेस (यूआई) से पहले ही हटाए गए अन्य फ़ील्ड भी हटा दिए गए हैं: custom_style, saved_style_id, mobile_content_ads_settings, feed_ads_settings.

Alert

• delete तरीका हटा दिया गया है.
• is_dismissible फ़ील्ड को हटा दिया गया है.
• locale फ़ील्ड का नाम बदलकर language_code कर दिया गया है.

CustomChannel

• code फ़ील्ड को हटा दिया गया है. यह वैल्यू अब भी name फ़ील्ड के आखिर में (आखिरी फ़ॉरवर्ड स्लैश के बाद) देखी जा सकती है.
• targeting_info फ़ील्ड को हटा दिया गया है, क्योंकि इसे AdSense के यूज़र इंटरफ़ेस (यूआई) से पहले ही हटा दिया गया है.

Payment

• payment_date फ़ील्ड का नाम बदलकर date रखा गया है और स्ट्रिंग टाइप से बदलकर google.type.Date टाइप कर दिया गया है.
• payment_amount फ़ील्ड और payment_amount_currency_code फ़ील्ड को एक साथ मिलाकर, एक payment फ़ील्ड बनाया गया है (उदाहरण के लिए, "1,235 येन", "1,234.57 डॉलर", "87.65 पाउंड").

शिकायत करें

• v2 वर्शन के साथ, AdSense मैनेजमेंट एपीआई का रिपोर्टिंग डेटा अब AdSense यूज़र इंटरफ़ेस (यूआई) के साथ अलाइन हो गया है. इसका मतलब है कि AdMob और YouTube प्रॉपर्टी अब काम नहीं करतीं. इसके अलावा, एपीआई सिर्फ़ तीन साल पहले का रिपोर्ट डेटा दिखाएगा.
• Metadata.dimensions संसाधन और Metadata.metrics संसाधन हटा दिया गया है.
• रिपोर्ट का CSV वर्शन जनरेट करने के लिए, नए तरीके जोड़े गए हैं. ये तरीके, v1.4 में क्वेरी पैरामीटर की जगह लेते हैं. ध्यान दें: डेटा को छोटा करने के लिए, अब भी एचटीटीपी हेडर "Accept-Encoding: gzip" का इस्तेमाल किया जा सकता है.
• ऐड-हॉक रिपोर्ट जनरेट करने की सुविधा में कुछ फ़ील्ड बदले गए हैं.
  • account_id फ़ील्ड का नाम बदलकर account कर दिया गया है.
  • dimension फ़ील्ड का नाम बदलकर dimensions कर दिया गया है.
  • metric फ़ील्ड का नाम बदलकर metrics कर दिया गया है.
  • filter फ़ील्ड का नाम बदलकर filters कर दिया गया है.
  • sort फ़ील्ड का नाम बदलकर order_by कर दिया गया है.
  • locale फ़ील्ड का नाम बदलकर language_code कर दिया गया है.
  • currency फ़ील्ड का नाम बदलकर currency_code कर दिया गया है.
  • अब date_range के साथ कई सामान्य रेंज तय की जा सकती हैं (उदाहरण के लिए, TODAY, YESTERDAY, MONTH_TO_DATE, YEAR_TO_DATE, LAST_7_DAYS, और LAST_30_DAYS) या date_range को CUSTOM पर सेट करके, start_date और end_date तय किए जा सकते हैं.
  • start_date और end_date फ़ील्ड को टाइप स्ट्रिंग से बदलकर टाइप google.type.Date कर दिया गया है. ध्यान दें: इससे, रिलेटिव डेट वाले कीवर्ड (उदाहरण के लिए, "today-6d") अब काम नहीं करते.
  • बूलियन फ़ील्ड use_timezone_reporting को reporting_time_zone से बदल दिया गया है. इसमें इनमें से कोई एक वैल्यू हो सकती है: ACCOUNT_TIME_ZONE या GOOGLE_TIME_ZONE (जिसका मतलब है पीएसटी/पीडीटी). v2 में डिफ़ॉल्ट तौर पर ACCOUNT_TIME_ZONE सेट होता है, जो v1.4 में डिफ़ॉल्ट तौर पर सेट किए गए वैल्यू से अलग है.
  • start_index फ़ील्ड को हटा दिया गया है.
  • max_results फ़ील्ड का नाम बदलकर limit कर दिया गया है.
• सेव की गई रिपोर्ट जनरेट करने पर, कुछ फ़ील्ड बदल गए हैं.
  • तारीख वाले फ़ील्ड जोड़े गए (date_range, start_date, end_date, reporting_time_zone).
  • currency_code फ़ील्ड जोड़ा गया.
  • locale फ़ील्ड का नाम बदलकर language_code कर दिया गया है.
  • start_index फ़ील्ड को हटा दिया गया है.
  • max_results फ़ील्ड को हटा दिया गया है.

SavedAdStyle

• SavedAdStyle को हटा दिया गया है, क्योंकि इसे पहले ही AdSense के यूज़र इंटरफ़ेस से हटा दिया गया है.

साइट

• Sites को उन वेबसाइटों का डेटा फ़ेच करने के लिए जोड़ा गया है जिन्हें आपने अपने AdSense खाते में जोड़ा है.
• state फ़ील्ड से पता चलता है कि साइट इनमें से किसी भी स्थिति में है या नहीं: REQUIRES_REVIEW, GETTING_READY, READY, NEEDS_ATTENTION.
• auto_ads_enabled फ़ील्ड एक बूलियन है, जो यह दिखाता है कि किसी साइट पर अपने-आप चलने वाले विज्ञापन चालू हैं या नहीं.

वर्शन 1.4

इस वर्शन में ये सुविधाएं शामिल हैं:

• अब AdSense खाते के पेमेंट की जानकारी, उससे जुड़ी मुद्रा में देखी जा सकती है.
• अब delete तरीके को कॉल करके, किसी सूचना को खारिज किया जा सकता है. इससे, एपीआई और AdSense वेब इंटरफ़ेस में सूचना छिप जाएगी.
• रिपोर्ट के जवाब में अब शुरू और खत्म होने की तारीखें शामिल हैं. यह ज़रूरी है कि अगर रिपोर्ट जनरेट करते समय, आपने today, yesterday, firstDayOfMonth-1m जैसी रिलेटिव तारीखों का इस्तेमाल किया है, तो जवाब में अब वह तारीख की सीमा शामिल होगी जिसके लिए आपने अनुरोध किया था.

ऐसी समस्याएं जिनकी जानकारी पहले से है

इस रिलीज़ में, रिपोर्ट में currency फ़ील्ड का इस्तेमाल नहीं किया जा सकता.

वर्शन 1.3

इस वर्शन में ये सुविधाएं शामिल हैं:

• सूचनाएं वापस पाने की सुविधा.
• मेट्रिक और डाइमेंशन का मेटाडेटा वापस पाने की सुविधा.
• खाते के स्थानीय टाइम ज़ोन में रिपोर्ट चलाने की सुविधा.

ऐसी समस्याएं जिनकी जानकारी पहले से है

इस रिलीज़ में, रिपोर्ट में currency फ़ील्ड का इस्तेमाल नहीं किया जा सकता.

वर्शन 1.2

इस वर्शन में ये सुविधाएं शामिल हैं:

• विज्ञापन स्टाइल को वापस पाने की सुविधा.
• फ़्रंटएंड में सेव की गई रिपोर्ट को वापस पाने और उन्हें चलाने की सुविधा.

ऐसी समस्याएं जिनकी जानकारी पहले से है

इस रिलीज़ में, रिपोर्ट में currency फ़ील्ड का इस्तेमाल नहीं किया जा सकता.

वर्शन 1.1

इस वर्शन में ये सुविधाएं शामिल हैं:

• उन खातों की सूची बनाने की सुविधा जिनका ऐक्सेस उपयोगकर्ता के पास है
• किसी खास खाते पर GET कॉल करने की सुविधा
• विज्ञापन यूनिट और कस्टम चैनलों पर GET कॉल करने की सुविधा
• विज्ञापन यूनिट और कस्टम चैनलों के बीच कनेक्शन तय करने की सुविधा
• कस्टम चैनलों में, टारगेटिंग की जानकारी के बारे में ज़्यादा डेटा होता है

इसके अलावा, अब डेटा को अपने डिफ़ॉल्ट खाते या किसी खास खाते से ऐक्सेस किया जा सकता है.

ऐसी समस्याएं जिनकी जानकारी पहले से है

इस रिलीज़ में, रिपोर्ट में currency फ़ील्ड का इस्तेमाल नहीं किया जा सकता.

वर्शन 1

यह एपीआई की पहली रिलीज़ है. इसमें विज्ञापन क्लाइंट, विज्ञापन यूनिट, कस्टम चैनल, यूआरएल चैनल को वापस पाने के साथ-साथ रिपोर्ट चलाने की सुविधा भी शामिल है.

ऐसी समस्याएं जिनकी जानकारी पहले से है

इस रिलीज़ में, रिपोर्ट में currency फ़ील्ड का इस्तेमाल नहीं किया जा सकता.