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

توفّر هذه الصفحة ملاحظات إصدار 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

حساب

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. على سبيل المثال، سيظهر اسم برنامج 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

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

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

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

الحقل "currency" في التقارير غير متاح في هذا الإصدار.

الإصدار 1

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

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

الحقل "currency" في التقارير غير متاح في هذا الإصدار.