تقدّم هذه الصفحة ملاحظات حول الإصدار لواجهة برمجة التطبيقات AdSense Management API.
الإصدار 2
يقدّم هذا الإصدار التغييرات التالية لإزالة وظائف المتوقفة نهائيًا ومواءمة AdSense Management API مع معايير Google API الحالية. وفقًا لمخطّط تحديد الإصدارات في Google API، سيتم تعديل هذا الإصدار بمرور الوقت لتضمين وظائف إضافية (متوافقة مع الأنظمة القديمة) بدلاً من طرح وظائف جديدة في إصدارات ثانوية منفصلة.
2025-02-24
PolicyIssues
- تمت إضافة حقل
policyTopics[].type
لتحديد ما إذا كان موضوع السياسة يمثّل مشكلة متعلّقة بالسياسة أو باللوائح التنظيمية أو الإعدادات المفضّلة للمعلِن. ويحلّ هذا الحقل محلّpolicyTopics[].must_fix
الذي تم وضع علامة عليه الآن كحقل متوقّف نهائيًا.
2024-04-03
PolicyIssues
- تمت إضافة مجموعة جديدة للإبلاغ عن انتهاكات السياسة الحالية والتحذيرات الحالية في الحساب.
2023-06-19
الدفعات
- يعرض payments.list الآن تفاصيل عن الدفعات التي تلقّاها الناشرون المشتركون في Premium.
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 لمنصّات الويب.
- تمت إضافة الحقل active إلى المورد.
الحسابات
- تمت إضافة طريقة 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
الدفع
-
تم توسيع نطاق تنسيق اسم المورد ليشمل موارد منفصلة
للأرباح في 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
. على سبيل المثال، سيظهر اسم "عميل إعلاني" على النحو التالي: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
الذي يمثّل المعرّف الفريد لعميل الإعلان كما هو مستخدَم في سمة reportingAD_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
. ملاحظة: نتيجةً لذلك، فإنّ الكلمات الرئيسية للتاريخ النسبي (مثل "today-6d") لم يعُد متاحًا. - تم
استبدال الحقل المنطقي
use_timezone_reporting
بـreporting_time_zone
، والذي يمكن أن يتضمّن إحدى القيمتَين:ACCOUNT_TIME_ZONE
أوGOOGLE_TIME_ZONE
(أي توقيت المحيط الهادئ/توقيت المحيط الهادئ الصيفي). القيمة التلقائية في الإصدار 2 هي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
هذا هو الإصدار الأول من واجهة برمجة التطبيقات. ويشمل ذلك إمكانية استرداد عملاء الإعلانات، والوحدات الإعلانية، والقنوات المخصّصة، وقنوات عناوين URL، بالإضافة إلى إمكانية عرض التقارير.
المشاكل المعروفة
لا يمكن استخدام الحقل currency
في التقارير في هذا الإصدار.