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

تعرض هذه الصفحة ملاحظات إصدار AdSense Management API.

الإصدار 2

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

2024-04-03

PolicyIssues

  • تمت إضافة مجموعة جديدة للإبلاغ عن انتهاكات السياسة الحالية والتحذيرات الواردة في أحد الحسابات.

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

  • تمت إضافة طريقة 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.

19-04-2021 (الإصدار الأوّلي)

الإعدادات العامة

  • تمت إزالة جميع الطرق المتوقّفة نهائيًا في الإصدار 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 (أي توقيت المحيط الهادئ أو توقيت المحيط الهادئ الصيفي). القيمة التلقائية في الإصدار 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 في التقارير في هذا الإصدار.