توفّر هذه الصفحة ملاحظات إصدار AdSense Management API.
الإصدار 2
يقدّم هذا الإصدار التغييرات التالية لإزالة الوظائف التي تم إيقافها نهائيًا ومواءمة واجهة برمجة تطبيقات AdSense Management API مع معايير 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
التي تسمح بتقسيم المقاييس حسب عنوان URL للصفحة (مع بعض التنبيهات، يمكنك الاطّلاع على تفاصيل عنوان URL للصفحة).
2022-09-21
AdUnits
- تمت إضافة طرق الإنشاء والتصحيح. تجدر الإشارة إلى أنّ هذه الطرق لا يمكن استخدامها إلا من خلال المشاريع التي تم تفعيلها لمنتج AdSense للمنصات.
CustomChannels
- تمت إضافة طرق الإنشاء والتصحيح والتعديل. تجدر الإشارة إلى أنّ هذه الطرق لا يمكن استخدامها إلا من خلال المشاريع التي تم تفعيلها لمنتج AdSense للمنصات.
- تمت إضافة الحقل النشط إلى المورد.
الحسابات
- تمت إضافة طريقة getAdBlockRecoveryTag.
2022-08-25
التقارير
- تمت إضافة السمة
HOSTED_AD_CLIENT_ID
التي تسمح للناشرين المضيفين وناشري المنصات بتقسيم المقاييس حسب حسابات الناشرين (الناشرون المضيفون) والحسابات الفرعية (ناشرو المنصة).
2022-05-03
AdClient
- تمت إضافة طريقة الحصول على البيانات.
التقارير
- تمت إضافة طريقة getSaved.
UrlChannels
- تمت إضافة طريقة الحصول على البيانات.
2022-03-31
حساب
- تعرض واجهة برمجة التطبيقات الآن الحسابات غير النشطة، مع ظهور حقل
state
يشير إلى حالة الحساب.
AdClient
- على غرار تغييرات الحساب المذكورة أعلاه، تعرض واجهة برمجة التطبيقات الآن برامج الإعلانات غير النشطة، مع حقل
state
يشير إلى حالة برنامج الإعلانات.
2022-02-24
الدفع
-
تم توسيع نطاق تنسيق اسم المورد ليشمل موارد منفصلة
لأرباح YouTube. تم إجراء هذا التغيير قبل الطرح التدريجي
لتجربة AdSense
المحسّنة لصنّاع المحتوى في YouTube، والتي سنقسّم فيها أرباح YouTube
في حساب الدفعات الخاصّ بها. وسيتم أيضًا عرض معلومات الدفع على YouTube
من طريقة قائمة الدفعات بعد أن يكون لديك
حساب دفعات مخصّص
لأرباح YouTube.
سيظهر اسم المورد التالي ضمن أرباح YouTube:
- accounts/{account}/payments/youtube-unpaid مقابل أرباح YouTube غير المدفوعة (الحالية)
- accounts/{account}/payments/youtube-yyyy-MM-dd لأرباح YouTube المدفوعة.
ملاحظة: لم تتغيّر أسماء الموارد الخاصة بأرباح AdSense:- accounts/{account}/payments/unpaid من أرباح AdSense غير المدفوعة (الحالية).
- accounts/{account}/payments/yyyy-MM-dd لأرباح AdSense المدفوعة.
2021-06-30
الإبلاغ
- تمت إضافة السمتَين
AD_FORMAT_NAME
وAD_FORMAT_CODE
، مشيرَين إلى طريقة عرض الإعلان للمستخدمين على موقعك الإلكتروني (إعلان في الصفحة، إعلان الشاشة الكاملة، وما إلى ذلك). يُرجى العلم بأنّ الإصدار 1.4 يتضمّن (تم إيقاف العمل به) سمات بنفس الأسماء ولكن مع أعضاء مختلفين، ويختلف البُعدان اللذان تمّت إضافتهما في الإصدار 2 عن السمات التي كانت متوفّرة في الإصدار 1.4.
2021-04-19 (الإصدار الأولي)
الإعدادات العامة
- تمت إزالة جميع الطُرق المتوقّفة نهائيًا في الإصدار 1.4. ويشمل ذلك طرق الموارد التي لم تكن تتطلّب
accountId
. في الإصدار 2، يتم تحديدaccountId
في الحقلparent
. - وفقًا لمعايير Google API، يتم الآن تحديد الموارد من خلال الحقل
name
. على سبيل المثال، سيظهر اسم برنامج AdClient على النحو التالي:accounts/{accountId}/adclients/{adClientId}
. بالإضافة إلى ذلك، في الإصدار 1.4، تم استخدام رقم تعريف المورد كسمة لإعداد التقارير، ولكن في الإصدار 2، أصبحت هذه القيمة متوفرة الآن من خلال الحقل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
.
تنبيه
- تمت إزالة طريقة
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 لم تعُد متاحة. بالإضافة إلى ذلك، لن تتيح واجهة برمجة التطبيقات سوى بيانات التقارير التي يعود تاريخها إلى 3 سنوات.
- تمت إزالة المورد
Metadata.dimensions
والموردMetadata.metrics
. - تمت إضافة طرق جديدة لإنشاء نسخة من التقرير بتنسيق CSV بدلاً من معلَمات طلب البحث في الإصدار 1.4. ملاحظة: بالنسبة إلى الضغط، لا يزال بإمكانك استخدام عنوان HTTP "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
)، أو يمكنك تحديدstart_date
وend_date
من خلال ضبطdate_range
علىCUSTOM
. - تم تغيير الحقلَين
start_date
وend_date
من نوع سلسلة إلى النوعgoogle.type.Date
. ملاحظة: نتيجةً لذلك، تتم مشاركة الكلمات الرئيسية ذات التاريخ النسبي (مثل "اليوم-6d") لم تعُد متوفّرة. - تم استبدال الحقل المنطقي
use_timezone_reporting
بالقيمةreporting_time_zone
التي يمكن أن تحتوي على إحدى القيمتَين التاليتَين:ACCOUNT_TIME_ZONE
أوGOOGLE_TIME_ZONE
(ما يعني PST/PDT). والرمز التلقائي في الإصدار 2 هوACCOUNT_TIME_ZONE
، وهو يختلف عن القيمة التلقائية في الإصدار 1.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
وهذا هو الإصدار الأول من واجهة برمجة التطبيقات. وهي تشمل دعمًا لاسترداد برامج الإعلانات والوحدات الإعلانية والقنوات المخصّصة وقنوات عناوين URL، فضلاً عن تشغيل التقارير.
المشاكل المعروفة
الحقل "currency
" في التقارير غير متاح في هذا الإصدار.