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

تعرض هذه الصفحة ملاحظات إصدار "واجهة برمجة التطبيقات لإدارة AdSense".

الإصدار 2

يقدم هذا الإصدار التغييرات التالية لإزالة الوظيفة التي تم إيقافها نهائيًا ومحاذاة واجهة برمجة تطبيقات AdSense Management مع معايير 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

الوحدات الإعلانية

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

القنوات المخصّصة

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

الحسابات

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

2022-08-25

التقارير

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

2022-05-03

AdClient

  • تمت إضافة طريقة الحصول على الإذن.

التقارير

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

UrlChannels

  • تمت إضافة طريقة الحصول على الإذن.

2022-03-31

حساب

AdClient

2022-02-24

الدفع

  • تم توسيع تنسيق اسم المورد ليشمل موارد منفصلة لأرباح YouTube. وقبل تطبيق هذا التغيير بشكل تدريجي على تجربة AdSense المحسّنة لمنشئي المحتوى في YouTube، والذي سيتم فيه تقسيم أرباح YouTube إلى حساب دفعات خاص. سيتم أيضًا عرض معلومات الدفع على YouTube من طريقة قائمة الدفعات، بعد إنشاء حساب دفعات مخصّص لأرباح YouTube. ستكون أرباح YouTube بالتنسيق التالي:
    • accounts/{account}/payments/youtube-unpaid for الأرباح غير المدفوعة (الحالية) YouTube
    • accounts/{account}/payments/youtube-yyyy-MM-dd لأرباح YouTube المدفوعة.

    ملاحظة: تظل أسماء الموارد لأرباح AdSense بدون تغيير:
    • accounts/{account}/payments/unpaid for the paid (current) التشفير المرتقَبة في 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. يمكن تنفيذ وظائف مشابهة في الإصدار الثاني باستخدام الطريقة المخصصة listChildAccounts. يمكن إنشاء العرض التدرّجي الكامل للحساب الفرعي في الإصدار 2 من خلال طلب listChildAccounts بشكل متكرر.

AdClient

  • تمت إزالة الحقل arc_opt_in لأنه سبق أن تمت إزالته من واجهة مستخدم AdSense.
  • يتم استبدال الحقل supports_reporting بالحقل reporting_dimension_id الذي يمثّل المعرّف الفريد لعميل الإعلان كما هو مستخدم في سمة إعداد تقارير AD_CLIENT_ID. إذا كانت قيمة reporting_dimension_id فارغة، هذا يعني أن AdClient لا يتيح إعداد التقارير.

الوحدة الإعلانية

  • تمت إعادة تسمية الحقل 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.

القنوات المخصّصة

  • تمت إزالة الحقل 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 جنيه إسترليني"

الإبلاغ

  • باستخدام الإصدار الثاني، تتوافق بيانات إعداد تقارير AdSense Management API مع واجهة مستخدم AdSense. وهذا يعني أنّ منصتَي AdMob وYouTube لم يعودا متوافقَين. بالإضافة إلى ذلك، ستوفّر واجهة برمجة التطبيقات بيانات التقارير منذ 3 سنوات فقط.
  • تمت إزالة المورد Metadata.dimensions والمورد Metadata.metrics.
  • تمت إضافة طرق جديدة لإنشاء نسخة من التقرير بتنسيق CSV، بدلاً من معلَمات طلب البحث في الإصدار 1.4. ملاحظة: بالنسبة إلى الضغط، لا يزال بإمكانك استخدام عنوان HTTP "قبول الترميز: 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، وهي تختلف عن القيمة التلقائية المتوفرة في الإصدار 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.

SaveAdStyle

  • تمت إزالة SavedAdStyle لأنه تمت إزالته من واجهة مستخدم AdSense.

الموقع الإلكتروني

  • تمّت إضافة "Sites" لجلب بيانات حول المواقع الإلكترونية التي أضفتها إلى حسابك على AdSense.
  • ويمثّل الحقل state ما إذا كان الموقع الإلكتروني أيًّا من الحالات التالية: REQUIRES_REVIEW أو GETTING_READY أو READY أو NEEDS_ATTENTION.
  • والحقل auto_ads_enabled هو قيمة منطقية تحدّد ما إذا كان قد تم تفعيل الإعلانات التلقائية على موقع إلكتروني معيّن.

الإصدار 1.4

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

  • يمكنك الآن إدراج دفعات حسابك في AdSense بالعملة المقابلة لها.
  • يمكنك الآن إغلاق تنبيه عن طريق استدعاء طريقة delete التي ستُخفي التنبيه في واجهة برمجة تطبيقات AdSense وواجهة الويب على AdSense.
  • تتضمن استجابة التقرير الآن تاريخَي البدء والانتهاء. هذه السمة مهمة إذا كنت تستخدم تواريخ نسبية عند إنشاء التقارير (مثل today وyesterday وfirstDayOfMonth-1m)، وستتضمّن الإجابة الآن النطاق الزمني الذي طلبته.

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

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

الإصدار 1.3

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

  • إمكانية استرداد التنبيهات.
  • إمكانية استرداد المقاييس والبيانات الوصفية للسمات.
  • إمكانية تشغيل التقارير بالمنطقة الزمنية المحلية للحساب.

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

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

الإصدار 1.2

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

  • إمكانية استرداد أنماط الإعلانات.
  • إمكانية استرداد التقارير المحفوظة المُحدَّدة في الواجهة الأمامية وتنفيذها.

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

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

الإصدار 1.1

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

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

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

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

الإصدار 1

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

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

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