इस पेज का अनुवाद Cloud Translation API से किया गया है.

रिलीज़ नोट्स

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

संस्करण 2

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

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 प्रॉडक्ट के लिए चालू किए गए प्रोजेक्ट के लिए किया जा सकता है.

CustomChannels

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

खाते

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 से होने वाली कमाई.
- YouTube से हुई कमाई के लिए accounts/{account}/payments/youtube-yyyy-MM-dd.
ध्यान दें: AdSense से होने वाली आय के संसाधन के नाम में कोई बदलाव नहीं होगा:
- accounts/{account}/payments/बकाया (मौजूदा) AdSense से होने वाली आय के लिए पेमेंट नहीं किया गया.
- पेमेंट की गई 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 में, 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 फ़ील्ड को हटा दिया गया है. इसी तरह की सुविधाएं, listChildAccounts को पसंद के मुताबिक बनाए गए तरीके का इस्तेमाल करके, v2 में हासिल की जा सकती हैं. listChildAccounts को बार-बार कॉल करके, v2 में पूरा चाइल्ड खाता ट्री जनरेट किया जा सकता है.

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 फ़ील्ड एक बूलियन है. इससे पता चलता है कि अपने-आप चलने वाले विज्ञापन किसी खास साइट पर चालू हैं या नहीं.