یادداشت های انتشار

این صفحه یادداشت‌های انتشار را برای API مدیریت AdSense ارائه می‌کند.

نسخه 2

این نسخه تغییرات زیر را به منظور حذف عملکرد منسوخ و تراز کردن API مدیریت AdSense با استانداردهای فعلی Google API معرفی می کند. بر اساس طرح نسخه‌سازی Google API ، این نسخه در طول زمان به‌روزرسانی می‌شود تا شامل عملکردهای اضافی (سازگار با عقب) باشد تا اینکه عملکرد جدیدی در نسخه‌های جزئی جداگانه منتشر شود.

03-04-2024

مسائل مربوط به سیاست

  • مجموعه جدیدی برای گزارش تخلفات خط‌مشی فعلی و هشدارهای موجود برای یک حساب اضافه شده است.

19-06-2023

مبلغ پرداختی

  • Pays.list اکنون جزئیات مربوط به پرداخت‌های ناشران ممتاز را برمی‌گرداند.

13-06-2023

گزارش ها

  • معیارهای FUNNEL_REQUESTS ، FUNNEL_IMPRESSIONS ، FUNNEL_CLICKS ، و FUNNEL_RPM اضافه شد که اطلاعاتی درباره عملکرد واحدهای غیر تبلیغاتی (به عنوان مثال، واحدهای جستجوی مرتبط) ارائه می‌کنند.

30-03-2023

گزارش ها

  • بعد PAGE_URL اضافه شد، که اجازه می‌دهد معیارها بر اساس URL صفحه تجزیه شوند (با برخی احتیاط‌ها، به تفکیک URL صفحه مراجعه کنید).

2022-09-21

AdUnits

  • اضافه شدن متدهای ایجاد و وصله توجه داشته باشید که این روش‌ها را فقط می‌توان توسط پروژه‌هایی که برای محصول AdSense for Platforms فعال هستند، استفاده کرد.

کانال های سفارشی

  • روش های ایجاد، وصله و به روز رسانی اضافه شد. توجه داشته باشید که این روش‌ها را فقط می‌توان توسط پروژه‌هایی که برای محصول AdSense for Platforms فعال هستند، استفاده کرد.
  • فیلد فعال را به منبع اضافه کرد.

حساب ها

  • متد getAdBlockingRecoveryTag اضافه شد.

2022-08-25

گزارش ها

  • بعد HOSTED_AD_CLIENT_ID اضافه شد، که به ناشران میزبان و پلتفرم اجازه می‌دهد معیارها را بر اساس حساب‌های ناشر خود (ناشر میزبان) و حساب‌های فرعی (ناشران پلتفرم) تجزیه و تحلیل کنند.

03-05-2022

AdClient

  • روش دریافت اضافه شد.

گزارش ها

  • روش getSaved اضافه شد.

کانال های URL

  • روش دریافت اضافه شد.

2022-03-31

حساب

AdClient

2022-02-24

پرداخت

  • قالب نام منبع برای پشتیبانی از منابع جداگانه برای درآمدهای YouTube گسترش یافته است. این تغییر قبل از عرضه تدریجی تجربه AdSense بهبودیافته برای سازندگان YouTube است که در آن درآمدهای YouTube به حساب پرداخت خودش جدا می‌شود. هنگامی که یک حساب پرداخت اختصاصی برای درآمد YouTube داشته باشید، اطلاعات پرداخت YouTube نیز از روش فهرست پرداخت ها بازگردانده می شود. درآمدهای YouTube دارای قالب نام منبع زیر خواهد بود:
    • حساب‌ها/{account}/payments/youtube-unpaid برای درآمدهای پرداخت نشده (جاری) YouTube.
    • حساب‌ها/{account}/payments/youtube-yyyy-MM-dd برای درآمدهای YouTube پولی.

    توجه: نام منابع برای درآمد AdSense بدون تغییر باقی می ماند:
    • accounts/{account}/payments/unpaid for unpaid (جاری) درآمد AdSense.
    • accounts/{account}/payments/yyyy-MM-dd برای درآمدهای پرداختی AdSense.

30-06-2021

گزارش

  • ابعاد AD_FORMAT_NAME و AD_FORMAT_CODE اضافه شده است، که نشان دهنده نحوه نمایش یک تبلیغ به کاربران در سایت شما است (در داخل صفحه، وینیت، و غیره). توجه داشته باشید که نسخه 1.4 دارای ابعاد (منسوخ شده) با نام های یکسان اما اعضای مختلف بود. دو بعد اضافه شده در v2 از ابعاد موجود در v1.4 متمایز است.

19-04-2021 (نسخه اولیه)

عمومی

  • همه روش های منسوخ شده در نسخه 1.4 حذف شده اند. این شامل روش‌های منبعی است که accountId نیازی ندارند. در v2، 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 به دست آورد. درخت حساب فرزند کامل را می توان با فراخوانی listChildAccounts به صورت بازگشتی در نسخه 2 ایجاد کرد.

AdClient

  • فیلد arc_opt_in حذف کرد زیرا قبلاً از رابط کاربری AdSense حذف شده است.
  • فیلد supports_reporting با قسمت reporting_dimension_id جایگزین می‌شود که نشان‌دهنده شناسه منحصربه‌فرد مشتری آگهی است که در بعد گزارش AD_CLIENT_ID استفاده می‌شود. اگر reporting_dimension_id خالی باشد، AdClient از گزارش پشتیبانی نمی‌کند.

AdUnit

  • فیلد status به state تغییر نام داده است. همچنین، وضعیت ACTIVE دیگر نشان نمی دهد که آیا در هفت روز گذشته فعالیتی در این واحد تبلیغاتی صورت گرفته است یا خیر. در v2، به این معنی است که واحد تبلیغات توسط کاربر فعال شده است و می تواند تبلیغات را ارائه دهد.
  • قسمت 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 ترکیب شده اند (به عنوان مثال، «1235 ین»، «1234.57 دلار»، «87.65 پوند»).

گزارش

  • با نسخه 2، داده‌های گزارش‌دهی API مدیریت AdSense اکنون با رابط کاربری AdSense همسو می‌شوند. این بدان معناست که ویژگی‌های AdMob و YouTube دیگر پشتیبانی نمی‌شوند. علاوه بر این، API فقط از داده های گزارش 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 )، یا می‌توانید با تنظیم date_range CUSTOM یک start_date و end_date را تعیین کنید.
    • فیلدهای start_date و end_date از نوع string به نوع google.type.Date تغییر یافته است. توجه: در نتیجه، کلمات کلیدی تاریخ نسبی (به عنوان مثال، "today-6d") دیگر پشتیبانی نمی شوند.
    • فیلد بولی use_timezone_reporting با reporting_time_zone جایگزین شده است که می تواند یکی از دو مقدار را داشته باشد: ACCOUNT_TIME_ZONE یا GOOGLE_TIME_ZONE (به معنی PST/PDT). پیش‌فرض در نسخه ۲ ACCOUNT_TIME_ZONE است که با پیش‌فرض نسخه ۱.۴ متفاوت است.
    • قسمت 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 که هشدار را در رابط وب API و AdSense پنهان می کند، هشدار را رد کنید.
  • پاسخ گزارش اکنون شامل تاریخ شروع و پایان است. اگر از تاریخ‌های نسبی هنگام تولید گزارش‌ها استفاده می‌کنید (مانند today ، yesterday ، firstDayOfMonth-1m )، این پاسخ اکنون شامل محدوده تاریخی است که درخواست کرده‌اید.

مشکلات شناخته شده

فیلد currency در گزارش‌ها در این نسخه پشتیبانی نمی‌شود.

نسخه 1.3

این نسخه عملکرد زیر را معرفی می کند:

  • امکان بازیابی هشدارها.
  • توانایی بازیابی متاداده های متریک و ابعاد.
  • امکان اجرای گزارش ها در منطقه زمانی محلی حساب.

مشکلات شناخته شده

فیلد currency در گزارش‌ها در این نسخه پشتیبانی نمی‌شود.

نسخه 1.2

این نسخه عملکرد زیر را معرفی می کند:

  • امکان بازیابی سبک های تبلیغاتی.
  • امکان بازیابی و اجرای گزارش های ذخیره شده تعریف شده در فرانت اند.

مشکلات شناخته شده

فیلد currency در گزارش‌ها در این نسخه پشتیبانی نمی‌شود.

نسخه 1.1

این نسخه عملکرد زیر را معرفی می کند:

علاوه بر این، اکنون می توانید به داده ها یا در حساب پیش فرض خود یا در یک حساب خاص دسترسی داشته باشید.

مشکلات شناخته شده

فیلد currency در گزارش‌ها در این نسخه پشتیبانی نمی‌شود.

نسخه 1

این اولین نسخه از API است. این شامل پشتیبانی برای بازیابی مشتریان تبلیغات، واحدهای تبلیغاتی، کانال های سفارشی، کانال های آدرس اینترنتی و همچنین اجرای گزارش ها می باشد.

مشکلات شناخته شده

فیلد currency در گزارش‌ها در این نسخه پشتیبانی نمی‌شود.