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

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

نسخه ۲

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

۲۰۲۶-۰۲-۰۵

گزارش‌ها

۲۰۲۵-۱۰-۰۲

گزارش‌ها

  • بُعد TRAFFIC_SOURCE اضافه شد که امکان تجزیه معیارها بر اساس منبع ترافیک (مثلاً "گوگل"، "بینگ"، "فیس‌بوک"، "سایر") را فراهم می‌کند. برای اطلاعات بیشتر، به تجزیه منبع ترافیک مراجعه کنید.

۲۰۲۵-۰۵-۰۶

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

  • فیلد منسوخ‌شده‌ی policyTopics[].must_fix (به‌روزرسانی قبلی مراجعه کنید) اکنون همیشه روی false تنظیم خواهد شد.

2025-02-24

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

۲۰۲۴-۰۴-۰۳

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

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

۲۰۲۳-۰۶-۱۹

پرداخت‌ها

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

۲۰۲۳-۰۶-۱۳

گزارش‌ها

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

۲۰۲۳-۰۳-۳۰

گزارش‌ها

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

۲۰۲۲-۰۹-۲۱

واحدهای تبلیغاتی

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

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

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

حساب‌ها

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

۲۰۲۲-۰۸-۲۵

گزارش‌ها

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

۲۰۲۲-۰۵-۰۳

کلاینت تبلیغاتی

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

گزارش‌ها

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

آدرس‌های کانال

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

۲۰۲۲-۰۳-۳۱

حساب کاربری

کلاینت تبلیغاتی

۲۴-۰۲-۲۰۲۲

پرداخت

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

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

۲۰۲۱-۰۶-۳۰

گزارش

  • ابعاد AD_FORMAT_NAME و AD_FORMAT_CODE اضافه شده‌اند که نحوه نمایش یک تبلیغ به کاربران در سایت شما (درون صفحه، حاشیه و غیره) را نشان می‌دهند. توجه داشته باشید که نسخه ۱.۴ ابعاد (منسوخ‌شده) با نام‌های یکسان اما اعضای متفاوت داشت؛ دو بُعد اضافه‌شده در نسخه ۲ با ابعاد موجود در نسخه ۱.۴ متفاوت هستند.

۲۰۲۱-۰۴-۱۹ (انتشار اولیه)

عمومی

  • تمام متدهای منسوخ‌شده در نسخه ۱.۴ حذف شده‌اند. این شامل متدهای منبعی می‌شود که نیازی به accountId نداشتند. در نسخه ۲، accountId در فیلد parent مشخص شده است.
  • طبق استانداردهای API گوگل، منابع اکنون توسط یک فیلد name شناسایی می‌شوند. برای مثال، نام یک AdClient به صورت accounts/{accountId}/adclients/{adClientId} خواهد بود. علاوه بر این، در نسخه ۱.۴ از شناسه منبع به عنوان یک بُعد گزارش‌دهی استفاده می‌شد، اما در نسخه ۲، این مقدار اکنون از طریق یک فیلد reporting_dimension_id در چندین منبع در دسترس است.
  • فیلد kind از تمام منابع حذف شده است.

حساب کاربری

  • فیلد name به display_name تغییر یافته است.
  • فیلد timezone از یک رشته به google.type.TimeZone تغییر یافته است.
  • فیلد creation_time (از نوع int64) به create_time (از نوع google.protobuf.Timestamp ) تغییر یافته است.
  • فیلد pending_tasks اضافه شد که فهرستی از وظایف معوقه است که باید به عنوان بخشی از فرآیند ثبت نام برای یک حساب کاربری جدید تکمیل شوند. برای مثال، وظایف می‌توانند مربوط به نمایه صورتحساب یا تأیید تلفن شما باشند.
  • فیلد sub_accounts حذف شده است. عملکرد مشابهی را می‌توان در نسخه ۲ با استفاده از متد سفارشی listChildAccounts به دست آورد. درخت کامل حساب‌های فرزند را می‌توان در نسخه ۲ با فراخوانی بازگشتی listChildAccounts ایجاد کرد.

کلاینت تبلیغاتی

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

واحد تبلیغات

  • فیلد status به state تغییر نام داده است. همچنین، حالت ACTIVE دیگر نشان نمی‌دهد که آیا در هفت روز گذشته فعالیتی روی این واحد تبلیغاتی انجام شده است یا خیر. در نسخه ۲، این به این معنی است که واحد تبلیغاتی توسط کاربر فعال شده و می‌تواند تبلیغات را نمایش دهد.
  • فیلد 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 تغییر نام داده شده و نوع آن از string به google.type.Date تغییر یافته است.
  • فیلدهای payment_amount و payment_amount_currency_code در یک فیلد payment واحد ترکیب شده‌اند (مثلاً "¥1,235 JPY"، "$1,234.57"، "£87.65").

گزارش

  • با نسخه ۲، داده‌های گزارش‌دهی API مدیریت AdSense اکنون با رابط کاربری AdSense همسو می‌شوند. این بدان معناست که دیگر از ویژگی‌های AdMob و YouTube پشتیبانی نمی‌شود. علاوه بر این، API فقط از داده‌های گزارش مربوط به ۳ سال پیش پشتیبانی می‌کند.
  • منابع Metadata.dimensions و Metadata.metrics حذف شده‌اند.
  • روش‌های جدیدی برای تولید نسخه CSV گزارش اضافه شده است که جایگزین پارامترهای پرس‌وجو در نسخه ۱.۴ شده‌اند. توجه: برای فشرده‌سازی، همچنان می‌توانید از هدر 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 حذف شده است زیرا قبلاً از رابط کاربری AdSense حذف شده است.

سایت

  • Sites اضافه شده‌اند تا اطلاعات مربوط به وب‌سایت‌هایی را که به حساب AdSense خود اضافه کرده‌اید، دریافت کنند.
  • فیلد state نشان می‌دهد که آیا سایت در هر یک از وضعیت‌های زیر قرار دارد یا خیر: REQUIRES_REVIEW ، GETTING_READY ، READY ، NEEDS_ATTENTION .
  • فیلد auto_ads_enabled یک مقدار بولی است که نشان می‌دهد آیا تبلیغات خودکار در یک سایت خاص فعال شده‌اند یا خیر.

نسخه ۱.۴

این نسخه قابلیت‌های زیر را معرفی می‌کند:

  • اکنون می‌توانید پرداخت‌های حساب ادسنس خود را به واحد پول مربوطه فهرست کنید.
  • اکنون می‌توانید با فراخوانی متد delete که هشدار را در رابط برنامه‌نویسی کاربردی (API) و رابط وب AdSense پنهان می‌کند، آن را رد کنید.
  • پاسخ گزارش اکنون شامل تاریخ‌های شروع و پایان است. این موضوع در صورتی که هنگام تولید گزارش‌ها از تاریخ‌های نسبی (مانند today ، yesterday ، firstDayOfMonth-1m ) استفاده می‌کنید، مهم است، پاسخ اکنون شامل محدوده تاریخی مورد درخواست شما می‌شود.

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

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

نسخه ۱.۳

این نسخه قابلیت‌های زیر را معرفی می‌کند:

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

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

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

نسخه ۱.۲

این نسخه قابلیت‌های زیر را معرفی می‌کند:

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

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

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

نسخه ۱.۱

این نسخه قابلیت‌های زیر را معرفی می‌کند:

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

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

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

نسخه ۱

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

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

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