रिलीज़ नोट्स

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

वर्शन 2

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

2025-10-02

रिपोर्ट

  • TRAFFIC_SOURCE डाइमेंशन जोड़ा गया है.इसकी मदद से, मेट्रिक को ट्रैफ़िक सोर्स के हिसाब से बांटा जा सकता है. जैसे, "Google", "Bing", "Facebook", "Other". ज़्यादा जानकारी के लिए, ट्रैफ़िक सोर्स ब्रेकडाउन देखें.

2025-05-06

PolicyIssues

  • अब बंद किए गए policyTopics[].must_fix फ़ील्ड (पिछला अपडेट देखें) को हमेशा false पर सेट किया जाएगा.

2025-02-24

PolicyIssues

2024-04-03

PolicyIssues

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

2023-06-19

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

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

2023-06-13

रिपोर्ट

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

2023-03-30

रिपोर्ट

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

खाता

AdClient

2022-02-24

Payment

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

    ध्यान दें: AdSense से हुई कमाई के लिए संसाधन के नाम नहीं बदले गए हैं:
    • accounts/{account}/payments/unpaid for unpaid (current) AdSense earnings.
    • accounts/{account}/payments/yyyy-MM-dd for paid AdSense earnings.

2021-06-30

शिकायत करें

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

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

सामान्य

  • v1.4 में बंद किए गए सभी तरीकों को हटा दिया गया है. इसमें ऐसे संसाधन के तरीके शामिल हैं जिनके लिए accountId की ज़रूरत नहीं थी. दूसरे वर्शन में, 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 फ़ील्ड को हटा दिया गया है. वर्शन 2 में, listChildAccounts कस्टम तरीके का इस्तेमाल करके, इसी तरह की सुविधा पाई जा सकती है. वर्शन 2 में, पूरे चाइल्ड खाते का ट्री जनरेट किया जा सकता है. इसके लिए, listChildAccounts को बार-बार कॉल करें.

AdClient

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

AdUnit

  • status फ़ील्ड का नाम बदलकर state कर दिया गया है. साथ ही, ACTIVE स्थिति से यह भी पता नहीं चलता कि पिछले सात दिनों में इस विज्ञापन यूनिट पर कोई गतिविधि हुई है या नहीं. दूसरे वर्शन में इसका मतलब है कि उपयोगकर्ता ने विज्ञापन यूनिट को चालू कर दिया है और अब इस पर विज्ञापन दिखाए जा सकते हैं.
  • 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 JPY", "$1,234.57", "£87.65").

शिकायत करें

  • AdSense Management API के 2.0 वर्शन में, रिपोर्टिंग डेटा अब 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 तरीके को कॉल करके, सूचना को खारिज किया जा सकता है. इससे सूचना, API और AdSense के वेब इंटरफ़ेस में नहीं दिखेगी.
  • रिपोर्ट के जवाब में अब शुरू और खत्म होने की तारीखें शामिल होती हैं. अगर रिपोर्ट जनरेट करते समय, तारीखों के लिए today, yesterday, firstDayOfMonth-1m जैसे शब्दों का इस्तेमाल किया जा रहा है, तो यह जानकारी ज़रूरी है. अब जवाब में, वह तारीख की सीमा शामिल होगी जिसके लिए आपने अनुरोध किया था.

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

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

वर्शन 1.3

इस वर्शन में ये सुविधाएं जोड़ी गई हैं:

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

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

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

वर्शन 1.2

इस वर्शन में ये सुविधाएं जोड़ी गई हैं:

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

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

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

वर्शन 1.1

इस वर्शन में ये सुविधाएं जोड़ी गई हैं:

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

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

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

वर्शन 1

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

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

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