रिलीज़ नोट्स

इस पेज पर, AdSense Management API की जानकारी दी गई है.

संस्करण 2

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

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 प्रॉडक्ट के लिए चालू किए गए प्रोजेक्ट में किया जा सकता है.
• ऐक्टिव फ़ील्ड को संसाधन में जोड़ा गया.

खाते

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

2022-08-25

रिपोर्ट

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

2022-05-03

AdClient

• पाने का तरीका जोड़ा गया.

रिपोर्ट

• getसेव किया गया तरीका जोड़ा गया.

UrlChannels

• पाने का तरीका जोड़ा गया.

2022-03-31

खाता

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

AdClient

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

2022-02-24

पेमेंट

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

2021-06-30

शिकायत करें

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

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

सामान्य

• वर्शन 1.4 में काम न करने वाले सभी तरीके हटा दिए गए हैं. इसमें ऐसे संसाधन भी शामिल हैं जिनके लिए accountId की ज़रूरत नहीं होती. वर्शन 2 में, parent फ़ील्ड में accountId की जानकारी दी गई है.
• Google API के मानकों के मुताबिक, अब संसाधनों की पहचान name फ़ील्ड से की जाती है. उदाहरण के लिए, AdClient का नाम accounts/{accountId}/adclients/{adClientId} जैसा दिखेगा. इसके अलावा, वर्शन 1.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 फ़ील्ड से बदल दिया जाता है, जो विज्ञापन क्लाइंट के उस यूनीक आईडी को दिखाता है जिसका इस्तेमाल AD_CLIENT_ID रिपोर्टिंग डाइमेंशन में किया गया है. अगर reporting_dimension_id खाली है, तो AdClient में रिपोर्टिंग की सुविधा नहीं है.

AdUnit

• status फ़ील्ड का नाम बदलकर state कर दिया गया है. साथ ही, ACTIVE स्थिति अब यह नहीं बताती कि पिछले सात दिनों में इस विज्ञापन यूनिट पर कोई गतिविधि हुई है या नहीं. वर्शन 2 में, इसका मतलब है कि विज्ञापन यूनिट को उपयोगकर्ता ने चालू कर दिया है और वह विज्ञापन दिखा सकती है.
• 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_date फ़ील्ड का नाम बदलकर date कर दिया गया है. साथ ही, टाइप स्ट्रिंग से google.type.Date टाइप में बदल दिया गया है.
• payment_amount फ़ील्ड और payment_amount_currency_code फ़ील्ड को मिलाकर एक payment फ़ील्ड बना दिया गया है (उदाहरण के लिए, "1,235 येन", "1,234.57 डॉलर", "87.65 पाउंड".

शिकायत करें

• वर्शन 2 से, AdSense Management API का रिपोर्टिंग डेटा अब AdSense यूज़र इंटरफ़ेस (यूआई) के साथ अलाइन हो गया है. इसका मतलब है कि अब AdMob और YouTube प्रॉपर्टी काम नहीं करतीं. इसके अलावा, यह एपीआई सिर्फ़ तीन साल पुरानी रिपोर्ट का डेटा इस्तेमाल करेगा.
• Metadata.dimensions संसाधन और Metadata.metrics संसाधन को हटा दिया गया है.
• रिपोर्ट का CSV वर्शन जनरेट करने के लिए, नए तरीके जोड़े गए हैं. ये तरीके, v1.4 में मौजूद क्वेरी पैरामीटर की जगह ले रहे हैं. ध्यान दें: कंप्रेस करने के लिए, अब भी एचटीटीपी हेडर "स्वीकार करें- एन्कोडिंग: 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 यूज़र इंटरफ़ेस (यूआई) से पहले ही हटा दिया गया है.

साइट

• आपने अपने AdSense खाते में जो वेबसाइट जोड़ी हैं उनका डेटा फ़ेच करने के लिए, Sites को जोड़ा गया है.
• 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 कॉल करने की सुविधा
• विज्ञापन यूनिट और कस्टम चैनलों पर कॉल पाने की सुविधा
• विज्ञापन यूनिट और कस्टम चैनल के बीच कनेक्शन तय करने की क्षमता
• कस्टम चैनल में, टारगेटिंग की जानकारी के बारे में ज़्यादा डेटा होता है

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

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

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

संस्करण 1

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

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

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