ملاحظات الإصدار

تقدّم هذه الصفحة ملاحظات حول الإصدار لواجهة برمجة التطبيقات AdSense Management API.

الإصدار 2

يقدّم هذا الإصدار التغييرات التالية لإزالة وظائف المتوقفة نهائيًا ومواءمة AdSense Management API مع معايير Google API الحالية. وفقًا لمخطّط تحديد الإصدارات في Google API، سيتم تعديل هذا الإصدار بمرور الوقت لتضمين وظائف إضافية (متوافقة مع الأنظمة القديمة) بدلاً من طرح وظائف جديدة في إصدارات ثانوية منفصلة.

2025-02-24

PolicyIssues

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

حساب

AdClient

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 الذي يمثّل المعرّف الفريد لعميل الإعلان كما هو مستخدَم في سمة reporting 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. ملاحظة: نتيجةً لذلك، فإنّ الكلمات الرئيسية للتاريخ النسبي (مثل "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

يقدّم هذا الإصدار الوظائف التالية:

بالإضافة إلى ذلك، يمكنك الآن الوصول إلى البيانات إما من خلال حسابك التلقائي أو من خلال حساب محدّد.

المشاكل المعروفة

لا يتوفّر الحقل currency في التقارير في هذا الإصدار.

الإصدار 1

هذا هو الإصدار الأول من واجهة برمجة التطبيقات. ويشمل ذلك إمكانية استرداد عملاء الإعلانات، والوحدات الإعلانية، والقنوات المخصّصة، وقنوات عناوين URL، بالإضافة إلى إمكانية عرض التقارير.

المشاكل المعروفة

لا يمكن استخدام الحقل currency في التقارير في هذا الإصدار.