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

توفّر هذه الصفحة ملاحظات الإصدار الخاصة بـ AdSense Management API.

الإصدار 2

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

2025-10-02

التقارير

  • تمت إضافة السمة TRAFFIC_SOURCE التي تتيح تقسيم المقاييس حسب مصدر الزيارات (مثل "Google" أو "Bing" أو "Facebook" أو "غير ذلك"). لمزيد من المعلومات، اطّلِع على تقسيم مصدر الزيارات.

2025-05-06

PolicyIssues

  • سيتم الآن ضبط الحقل policyTopics[].must_fix المتوقّف نهائيًا (راجِع التحديث السابق) على القيمة false دائمًا.

2025-02-24

PolicyIssues

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 للمنصات.
  • تمت إضافة الحقل النشط إلى المرجع.

الحسابات

  • تمت إضافة طريقة getAdBlockingRecoveryTag.

2022-08-25

التقارير

  • تمّت إضافة السمة HOSTED_AD_CLIENT_ID، التي تتيح للناشرين المضيفين وناشري المنصّات تقسيم المقاييس حسب حسابات الناشرين (الناشرون المضيفون) وحسب الحسابات الفرعية (ناشرو المنصّات).

2022-05-03

AdClient

  • تمت إضافة طريقة get.

التقارير

  • تمت إضافة طريقة getSaved.

UrlChannels

  • تمت إضافة طريقة get.

2022-03-31

الحساب

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 JPY", "$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") are no longer supported.
    • تم استبدال الحقل المنطقي 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 في التقارير في هذا الإصدار.