برای دریافت فهرست به‌روز ویژگی‌های منسوخ‌شده فعلی و برنامه‌ریزی‌شده، به ویژگی‌های منسوخ‌شده، برای دریافت تاریخ‌های چرخه حیات نسخه، به جدول زمانی منسوخ شدن و پایان کار، و برای دریافت جدول‌های تفاوت پروتو نسخه به نسخه قابل‌فیلتر کردن، به ارتقا دادن نسخه API مراجعه کنید.
خلاصه نسخه پخش و پیوندهای سریع
از جدول زیر برای رفتن مستقیم به تغییرات اساسی، ویژگی‌های جدید، یا جدول‌های تفاوت proto در نسخه پخش استفاده کنید:
نسخه عمده v26
Google Ads API v26 شامل ویژگی‌های جدید، به‌روزرسانی‌ها، و تغییرات اساسی زیر است.
نسخه ۲۶ (۲۰۲۶/۱۰/۱۴)
ویژگی‌های جدید، به‌روزرسانی‌ها، و تغییرات اساسی زیر در Google Ads API نسخه ۲۶ که یک نسخه اصلی است اضافه شده است.
برای راهنمایی، ارتقا به جدیدترین نسخه را ببینید.
تغییرات ناسازگار
| حالت اولیه | ایالت جدید | نوع تغییر | راهنمای پیاده‌سازی |
|---|---|---|---|
| پویش‌ها | |||
فیلد اختیاری country_code در LocalServicesPmaxCampaignSettings |
فیلد الزامی درطول ایجاد پویش «عملکرد بیشینه» خدمات محلی (LocalServicesPmaxCampaignSettings.country_code) |
تغییر رفتاری | مطمئن شوید که هنگام ایجاد کمپین‌های «عملکرد بیشینه» «خدمات محلی»، country_code (همراه با listing_id که به‌تازگی الزامی شده است) را مشخص کنید. |
| تبدیل‌ها | |||
فیلد enhanced_conversions_for_leads_enabled در ConversionTrackingSetting (Customer.conversion_tracking_setting) |
هیچ‌کدام | برداشتن | به‌جای آن، از ConversionTrackingSetting.enablement_setting در Customer.conversion_tracking_setting برای بررسی تنظیم «تبدیل‌های بهبودیافته» در سطح حساب استفاده کنید. |
| هدف‌گیری | |||
فیلدهای معیار مختص هتل در AdGroupBidModifier:
|
فیلدهای معیار مستقل از عمودی در AdGroupBidModifier:
|
تغییر نام / برداشتن | مرجع‌ها را به‌روز کنید تا از فیلدهای معیار مستقل از عمودی استفاده کنند، که از هدف‌یابی در عمودی‌های سفر فراتر از هتل‌ها (مانند «فعالیت‌های پیشنهادی») پشتیبانی می‌کنند. شناسه‌های معیار، رفتار هدف‌یابی، و اصلاح‌کننده‌های پیشنهاد قیمت موجود ثابت می‌مانند. مقادیر min_nights و max_nights همان‌طور که هستند به min_days و max_days منتقل می‌شوند. |
HotelDateSelectionType و نوع segments.user_set_dates |
DateSelectionType |
تغییر نام / تغییر نوع | به‌جای HotelDateSelectionType از DateSelectionType استفاده کنید. |
دلایل خطای مختص هتل در CriterionError:
|
دلایل خطای مستقل از عمودی در CriterionError:
|
تغییر نام | مدیریت خطای به‌روزرسانی را بررسی کنید تا دلایل خطای جدید مستقل از عمودی را بررسی کنید. |
ویژگی‌ها و به‌روزرسانی‌ها (غیرمخرب)
| ویژگی‌ها و به‌روزرسانی‌ها | نوع | شرح |
|---|---|---|
| دارایی‌ها | ||
| ارائه‌دهندگان پیام کسب‌وکار LINE و پیامک | فیلدها و مقادیر شمارشی جدید | پشتیبانی از LINE و پیامک به‌عنوان ارائه‌دهندگان پیام در BusinessMessageAsset اضافه شد، ازجمله فیلدهای جدید BusinessMessageAsset.line_info و BusinessMessageAsset.sms_info به‌همراه BusinessMessageProvider.LINE و BusinessMessageProvider.SMS. |
AssetGroupError.UNSUPPORTED_LOCAL_SERVICES_CATEGORY |
مقدار enum جدید / خطا | به AssetGroupError اضافه شد تا نشان دهد چه زمانی دسته‌ای که در GoogleLocalServicesInfo (AssetGroup.google_local_services_info) مشخص شده است برای پویش‌های «عملکرد بیشینه» خدمات محلی پشتیبانی نمی‌شود. |
| پویش‌ها | ||
| ایجاد پویش «عملکرد بیشینه» برای «خدمات محلی» | ویژگی‌ها، فیلدها، و خطای جدید |
همچنین |
| خطاهای اعتبارسنجی کمپین «خدمات محلی» | مقادیر enum و خطاهای جدید | خطاهای اعتبارسنجی جدیدی برای کمپین‌های «خدمات محلی» اضافه شد: |
| اعتبارسنجی پیوند حساب Hotel Center | مقدار enum جدید / خطا | کد خطای CampaignError.HOTEL_PROPERTY_ASSET_SET_HOTEL_CENTER_LINK_REQUIRED به CampaignError اضافه شد تا نشان دهد که پیوند دادن مجموعه دارایی‌های ملک هتل (Campaign.hotel_property_asset_set) به کمپین «عملکرد بیشینه» برای اهداف سفر به پیوند حساب فعال Hotel Center نیاز دارد. |
| حداقل بودجه روزانه «تولید تقاضا» | فیلد جدید | فیلد demand_gen_info.minimum_budget_per_day_micros به CurrencyConstant اضافه شد که حداقل بودجه لازم در روز را برای پویش‌های «تولید تقاضا» به آن ارز مشخص می‌کند. وقتی حداقل بودجه اعمال‌شده توسط API تغییر کند، مقدار این فیلد به‌روز می‌شود. |
| پیکربندی اندازه‌گیری بهینه‌گر برای پویش‌ها | فیلد جدید | Campaign.lift_measurement_config اضافه شد تا نام منبع پیکربندی سنجش بهینه‌گر پیوندشده به پویش را نشان دهد. |
| اعتبارسنجی آزمایش «بیشینه‌سازی هوشواره‌ای» | مقدار enum جدید / خطا | کد خطای ExperimentArmError.ADOPT_AI_MAX_CAMPAIGN_ALREADY_ENABLED به ExperimentArmError اضافه شد، هنگام تلاش برای ایجاد آزمایش ADOPT_AI_MAX برای پویشی که قبلاً «بیشینه‌سازی هوشواره‌ای» در آن فعال شده است (یا در همان درخواست قبل‌از ایجاد شاخه آزمایش فعال شده است). |
| نوع فهرستگان پویش Shopping | پشتیبانی گسترده | پشتیبانی گسترده از Campaign.listing_type در پویش‌های Shopping. |
| به‌روزرسانی‌های خوداظهاری تبلیغات سیاسی اتحادیه اروپا | رفتار به‌روزشده و فیلدهای جدید |
|
| تبدیل‌ها | ||
| پیکربندی «تبدیل‌های بهبودیافته» یکپارچه | فیلدها و شمارش‌های جدید | ConversionTrackingSetting.enablement_setting و ConversionTrackingSetting.effective_enablement_setting (در Customer.conversion_tracking_setting) برای نمایش پیکربندی یکپارچه «تبدیل‌های بهبودیافته» برای حساب اضافه شد که بااستفاده از شمارش جدید EnhancedConversionsConfig نشان داده می‌شود. |
ConversionActionCategory.MESSAGE_LEAD |
مقدار شمارشی جدید | به ConversionActionCategory اضافه شد تا از تعاملات پیام یا گپ که نشان‌دهنده علاقه به پیشنهاد آگهی‌دهنده است پشتیبانی کند. |
ConversionAttributionEventType.CLICK |
مقدار شمارشی جدید | به ConversionAttributionEventType اضافه شد تا نشان‌دهنده تبدیل‌های منسوب به کلیک آگهی باشد که قبلاً در مقدار شمارشی UNKNOWN گنجانده شده بود. |
| عمومی | ||
| به‌روزرسانی‌های مشتریان بالقوه «خدمات محلی» | فیلد جدید و مقدار شمارشی |
|
| توصیه‌ها | ||
| توصیه افزایش بودجه برای «جستجو» | توصیه جدید | RecommendationType.RAISE_BUDGET_PERFORMANCE_TOO_LOW، Recommendation.raise_budget_performance_too_low_recommendation، و ApplyRecommendationOperation.raise_budget_performance_too_low برای پشتیبانی از افزایش بودجه‌ها در زمانی که بودجه‌های روزانه برای «پویش‌های جستجو» خیلی کم است اضافه شد. |
| گزارش‌ها | ||
| اندازه‌گیری‌های بهینه‌گر جستجو | ویژگی‌ها، منابع، بخش‌ها، و سنجه‌های جدید | پشتیبانی از اندازه‌گیری‌های «بهینه‌گر جستجو» اضافه شد:
|
| نمای دارایی گسترش نشانی وب نهایی برای پویش‌های Shopping | پشتیبانی گسترده | final_url_expansion_asset_view برای پشتیبانی از پویش‌های Shopping گسترش یافته است (با ad_group که به‌عنوان منبع منسوب درکنار final_url_expansion_asset_view.ad_group قابل‌انتخاب است). |
| ویدیوها | ||
| شفاف‌سازی‌های محتوای زایای YouTube | فیلدها و شمارش‌های جدید | پشتیبانی از شفاف‌سازی محتوای زایا برای بارگذاری‌های YouTube اضافه شد. فیلد جدید YouTubeVideoUpload.video_content_metadata از نوع VideoContentMetadata به YouTubeVideoUpload اضافه شده است که حاوی تنظیمات شفاف‌سازی تحت VideoContentMetadata.generative_content_disclosure از نوع YouTubeVideoUploadGenerativeContentDisclosure است. |
نسخه‌های اصلی و فرعی v25
Google Ads API v25 شامل ویژگی‌های جدید، به‌روزرسانی‌ها، و تغییرات اساسی زیر است.
نسخه ۲۵.۲ (۲۰۲۶/۰۹/۲۳)
ویژگی‌ها و به‌روزرسانی‌های جدید زیر در Google Ads API نسخه ۲۵.۲ اضافه شده است. نسخه‌های جزئی مثل v25.2 حاوی تغییرات ناگهانی نیستند.
| ویژگی‌ها و به‌روزرسانی‌ها | نوع | شرح |
|---|---|---|
| دارایی‌ها | ||
گزینه‌های نشانی وب برای AssetGroup |
فیلدهای جدید | پشتیبانی از گزینه‌های نشانی وب در AssetGroup اضافه شد، که به تبلیغ‌کنندگان اجازه می‌دهد الگوهای ردگیری، پارامترهای سفارشی، و پسوندهای نشانی وب نهایی را در سطح گروه دارایی مشخص کنند:
|
| پویش‌ها | ||
| اطلاعات خزیدن خودکار ویدیو | فیلدها و شمارش‌های جدید | AutomatedVideoCrawlSetting به Campaign.AssetAutomationSetting اضافه شد، همراه با AssetAutomationType.AUTOMATED_VIDEO_CRAWL، که به شما امکان می‌دهد تنظیمات خزیدن خودکار ویدیو را برای پویش «بیشینه‌سازی عملکرد» مشخص کنید. AutomatedVideoCrawlSetting.automated_video_crawl_infos حاوی فهرستی از ورودی‌های AutomatedVideoCrawlInfo است که هرکدام یک url خزیدن، source_platform (VideoCrawlSourcePlatform: LANDING_PAGE، SOCIAL، یا YOUTUBE)، و وضعیت موافقت enabled را پیکربندی می‌کنند. |
| خطاهای ضریب ارزش «بهینه‌سازی چرخه حیات مشتری» | مقادیر enum و خطاهای جدید | دلایل جدیدی برای خطای اعتبارسنجی هنگام پیکربندی ضریب‌های ارزش (value_multiplier و high_lifetime_value_multiplier) برای «بهینه‌سازی چرخه حیات مشتری» اضافه شد:
|
SmartCampaignSettingService.GeneratePMaxDraftCampaign |
ویژگی جدید | SmartCampaignSettingService.GeneratePMaxDraftCampaign برای پشتیبانی از تولید پویش پیش‌نویس «بیشینه‌سازی عملکرد» از پویش «هوشمند» موجود اضافه شد، که با وضعیت CampaignStatus.PAUSED و وضعیت ایجاد CampaignCreationStatus.INCOMPLETE مقداردهی اولیه شده است (به تبدیل پویش‌های هوشمند به پویش‌های «بیشینه‌سازی عملکرد» مراجعه کنید):
|
| تبدیل‌ها | ||
| ظهورهای آگهی Firebase | انواع و دسته کنش تبدیل جدید | انواع کنش تبدیل FIREBASE_ANDROID_APP_AD_IMPRESSION و FIREBASE_IOS_APP_AD_IMPRESSION را درمعرض دید قرار دادیم تا بتوانید این کنش‌های تبدیل را بازیابی و اصلاح کنید. همچنین دسته IN_APP_AD_REVENUE را در ConversionActionCategory برای ردیابی درآمد خالص از درآمدزایی آگهی درون‌برنامه آشکار کرد. |
| عمومی | ||
BusinessProfileLocationSyncError |
enum و خطاهای جدید | دلایل خطاهای همگام‌سازی مکان «نمایه کسب‌وکار» هنگام همگام‌سازی مکان‌ها در AssetSet با نوع LOCATION_SYNC اضافه شد. اکنون API به‌جای برگرداندن خطای عمومی UNKNOWN، BusinessProfileLocationSyncError را با دلایل خاص (EMAIL_INVALID، OAUTH_TOKEN_INVALID، ACCOUNT_REMOVED، و NO_PERMISSION_TO_ACCESS_LOCATION_ACCOUNT) برمی‌گرداند. |
| برنامه‌ریزی | ||
سنجه‌های صدک BenchmarksService.GenerateBenchmarksMetrics |
ویژگی‌های جدید |
پشتیبانی از سنجه‌های صدک برای تاریخ‌های سه‌ماهه باز در خطای سفارشی |
| نام‌های کاربری کانال YouTube برای اطلاعات آماری محتواساز | ویژگی جدید | ContentCreatorInsightsService.GenerateCreatorInsights به‌روزرسانی شد تا از جستجوی نام‌های کاربری کانال YouTube بااستفاده از YouTubeChannels.youtube_channel_handles پشتیبانی کند (نام‌های کاربری معتبر کانال باید با @ شروع شوند، مثل @channel_handle). این گزینه مشابه جستجو براساس شناسه کانال YouTube است. پاسخ حاوی اطلاعات آماری درباره محتواسازان YouTube درخواست‌شده است. |
| توصیه‌ها | ||
| توصیه‌های پیشنهاد قیمت «کنش‌بها» و «برگشت هزینه‌های تبلیغات» | توصیه‌های جدید | Recommendation.raise_target_cpa_performance_bid_too_low_recommendation (RAISE_TARGET_CPA_PERFORMANCE_BID_TOO_LOW) و Recommendation.lower_target_roas_performance_bid_too_low_recommendation (LOWER_TARGET_ROAS_PERFORMANCE_BID_TOO_LOW)، به‌همراه ApplyRecommendationOperation.raise_target_cpa_performance_bid_too_low و ApplyRecommendationOperation.lower_target_roas_performance_bid_too_low اضافه شد تا از افزایش «کنش‌بهای هدف» یا کاهش «برگشت هزینه‌های تبلیغات هدف» در شرایطی که قیمت‌های پیشنهادی برای ورود «پویش‌های جستجو» به مزایده‌ها خیلی پایین است پشتیبانی شود:
|
| گزارش‌ها | ||
| بخش‌های بعد برنامه سفر هتل | بخش‌های جدید | بخش‌های بُعد برنامه سفر رزرو هتل و سفر زیر به Segments اضافه شد (قابل‌انتخاب با campaign، ad_group، و customer):
|
| سنجه‌های آگهی‌های عمودی | معیارهای سنجش جدید | سنجه‌های زیر برای گزارش‌دهی آگهی‌های عمودی هتل و سفر به Metrics اضافه شد (قابل‌انتخاب با campaign، ad_group، و customer):
|
| بخش‌های آگهی‌های عمودی | بخش‌های جدید | بخش‌های زیر برای گزارش‌دهی آگهی‌های عمودی هتل و سفر به Segments اضافه شد (قابل‌انتخاب با campaign، ad_group، و customer):
|
نسخه ۲۵.۱ (۲۰۲۶/۰۸/۱۹)
ویژگی‌ها و به‌روزرسانی‌های جدید زیر در Google Ads API نسخه ۲۵.۱ اضافه شده است. نسخه‌های جزئی مثل v25.1 حاوی تغییرات ناگهانی نیستند.
| ویژگی‌ها و به‌روزرسانی‌ها | نوع | شرح |
|---|---|---|
| دارایی‌ها | ||
AssetFieldType.TEXT_DISCLAIMER ServedAssetFieldType.TEXT_DISCLAIMER |
مقادیر شمارشی جدید | پشتیبانی از دارایی‌های بیانیه سلب مسئولیت نوشتاری اضافه شد. |
| پویش‌ها | ||
Campaign.aca_migration_date_time Campaign.broad_match_migration_date_time |
فیلدهای جدید | انتقال خودکار آتی به «بیشینه‌سازی هوشواره‌ای» را پیگیری کنید. |
| تبدیل‌ها | ||
| سنجش‌های بهینه‌گر نمانام | ویژگی‌های جدید | پشتیبانی از سنجش‌های «بهینه‌گر نمانام» با به‌روزرسانی‌های زیر اضافه شد:
|
| اندازه‌گیری‌های بهینه‌گر تبدیل | ویژگی‌های جدید | پشتیبانی از سنجش‌های «بهینه‌گر تبدیل» با به‌روزرسانی‌های زیر اضافه شد:
|
LiftMeasurementFlight |
منبع جدید | منبع جدید فقط خواندنی که جزئیات پرواز را برای پیکربندی اندازه‌گیری بهینه‌گر نشان می‌دهد، ازجمله تاریخ شروع و پایان پرواز اندازه‌گیری‌شده (start_date و end_date). |
| عمومی | ||
SmartCampaignError |
مقادیر شمارشی جدید | کدهای خطای خاص جدیدی برای محدودیت‌های تولید «عملکرد بیشینه» اضافه شده است: |
AuthorizationErrorEnum.CLOUD_PROJECT_NOT_APPROVED_FOR_PRODUCTION |
مقدار enum جدید / خطا | وقتی پروژه Google Cloud با سطح دسترسی TEST تلاش می‌کند درخواست‌هایی را برای حساب غیرآزمایشی ارسال کند، این خطا برگردانده می‌شود. |
| برنامه‌ریزی | ||
| اطلاعات آماری احساسات نمانام | ویژگی‌های جدید | پشتیبانی از اطلاعات آماری احساسات نمانام در ContentCreatorInsightsService اضافه شد:
|
بهبودهای BenchmarksService |
ویژگی‌های جدید | پشتیبانی از دسته‌ها به‌عنوان فیلتر برای تعیین محدوده تحلیل محک‌زنی اضافه شد. همچنین از سنجه‌های بحرانی کسب‌وکار اضافی پشتیبانی می‌کند:
|
| هدف‌یابی وضعیت والدینی | ویژگی جدید | پشتیبانی از هدف‌یابی وضعیت والدین در برنامه‌ریزی دسترسی اضافه شد. فیلد جدید parental_statuses به Targeting برای سرویس ReachPlanService.GenerateReachForecast، و parental_statuses به PlannableTargeting برای سرویس ReachPlanService.ListPlannableProducts اضافه شد. |
| توصیه‌ها | ||
Recommendation.campaign_specific_app_goal_recommendation |
توصیه جدید | افزودن هدف تبدیل برنامه خاص پویش را پیشنهاد می‌کند. منبع جدید EffectiveAutomaticGoal برای نشان دادن اهداف فعلی در این توصیه استفاده می‌شود. |
| گزارش‌ها | ||
Metrics.original_conversion_value |
فیلد جدید | نشان‌دهنده ارزش تبدیل اصلی از تبدیل‌های پیشنهاد قیمت دادنی است. این مقدار تبدیل‌های بدون تعدیل قبل‌از اعمال هرگونه تعدیل قانون مقدار، مانند قوانین مقدار تبدیل یا تعدیل اهداف چرخه حیات است. |
| آمار عضویت در برنامه وفاداری | ویژگی‌های جدید | پشتیبانی از بخش‌بندی آمار براساس وضعیت برنامه عضویت وفاداری کاربر اضافه شد و بُعد اصلی عضویت وفاداری برای قوانین ارزش تبدیل اضافه شد:
|
| هدف‌گیری | ||
vertical_ads_item_bid |
نوع معیار جدید | نوع معیار جدید vertical_ads_item_bid به AdGroupCriterion.criterion اضافه شد. |
نسخه ۲۵ (۲۰۲۶/۰۷/۲۲)
ویژگی‌های جدید، به‌روزرسانی‌ها، و تغییرات اساسی زیر در Google Ads API نسخه ۲۵ که یک نسخه اصلی است اضافه شده است.
برای راهنمایی، ارتقا به جدیدترین نسخه را ببینید.
تغییرات ناسازگار
| حالت اولیه | ایالت جدید | نوع تغییر | راهنمای پیاده‌سازی |
|---|---|---|---|
| پویش‌ها | |||
فیلدهای مستقل additional_value و additional_high_lifetime_value در CustomerLifecycleOptimizationValueSettings |
به‌ترتیب بخشی از value_adjustment و high_lifetime_value_adjustment oneofs، درکنار فیلدهای جدید value_multiplier و high_lifetime_value_multiplier |
تغییر ساختاری | مرجع‌های این فیلدها را به‌روز کنید زیرا اکنون بخشی از oneofs هستند. |
منابع قدیمی CustomerLifecycleGoal و CampaignLifecycleGoal، سرویس‌های مربوطه آن‌ها CustomerLifecycleGoalService و CampaignLifecycleGoalService، و تنظیمات/شمارش‌های قدیمی (CustomerAcquisitionGoalSettings، CustomerAcquisitionOptimizationModeEnum، LifecycleGoalValueSettings) |
هیچ‌کدام | برداشتن | از طرح‌واره اهداف یکپارچه اصلاح‌شده استفاده کنید:
|
| عمومی | |||
فیلدهای شمارشی تودرتو در پیام‌های درخواست و پاسخ «سرویس پاداش»:
|
فیلدهای شمارشی مستقل: | تغییر نام / برداشتن | به‌جای فیلدهای قدیمی type، از فیلدهای شمارشی مستقل جدید استفاده کنید. |
فیلدهای اختیاری selected_incentive_id و customer_id در ApplyIncentiveRequest |
قسمت‌های الزامی | تغییر رفتاری | مطمئن شوید که هنگام فراخوانی ApplyIncentive، هر دو فیلد را ارائه می‌دهید. |
فیلد نشانی ایمیل مصرف‌کننده ContactDetails.email در منبع LocalServicesLead |
هیچ‌کدام | برداشتن | ارجاع‌ها به این فیلد را بردارید چون دیگر پشتیبانی نمی‌شود. |
فیلد اختیاری allowed_domain در AdvertisingPartnerLinkInvitationProperties |
فیلد الزامی هنگام فراخوانی CreateProductLinkInvitation برای شریک تبلیغات |
تغییر رفتاری | مطمئن شوید که هنگام ایجاد دعوت پیوند محصول برای شریک تبلیغاتی، allowed_domain را ارائه می‌دهید. |
| برنامه‌ریزی | |||
فیلد search_brand در GenerateCreatorInsightsRequest |
هیچ‌کدام | برداشتن | درعوض از search_topics استفاده کنید. |
فیلد plannable_location_id در Targeting و فیلد cookie_frequency_cap در GenerateReachForecastRequest |
هیچ‌کدام | برداشتن | به استفاده از plannable_location_ids و cookie_frequency_cap_setting بروید. |
| گزارش‌ها | |||
فیلد customer_metrics در GenerateBenchmarksMetricsResponse و BreakdownMetrics از نوع Metrics |
فیلد از نوع CustomerMetrics |
تغییر نوع / تغییر رفتاری | ادغام‌هایتان را به‌روز کنید تا از نوع جدید CustomerMetrics استفاده کنند که فقط شامل سنجه‌هایی است که عملکرد آگهی مشتری را نشان می‌دهد. |
ویژگی‌ها و به‌روزرسانی‌ها (غیرمخرب)
| ویژگی‌ها و به‌روزرسانی‌ها | نوع | شرح |
|---|---|---|
| آگهی‌ها | ||
AssetAutomationType.GENERATE_ANIMATED_IMAGES_FROM_OTHER_ASSETS |
مقدار / رفتار enum جدید | دردسترس برای DemandGenMultiAssetAds. اگر فعال باشد، بااستفاده از تصاویر غیرپویانمایی‌شده به‌عنوان ورودی، تصاویر پویانمایی‌شده تولید می‌کند. DemandGenMultiAssetAds جدید به‌طور پیش‌فرض از این نسخه API شروع می‌شود. |
| تغییرپذیری اطلاعات محتوای مصنوعی | تغییر رفتار | Asset.synthetic_content_info و Ad.synthetic_content_info اکنون در نسخه‌های ۲۵، ۲۴، و ۲۳ کاملاً قابل‌تغییر هستند. |
| پویش‌ها | ||
| هدف حفظ مشتری وفادار | ویژگی‌ها / تنظیمات جدید | پشتیبانی از «هدف حفظ وفاداری» اضافه شد که به تبلیغ‌کنندگان امکان می‌دهد پویش‌ها را برای حفظ اعضای برنامه وفاداری بهینه‌سازی کنند.
|
| هدف «جذب مشتری جدید» | ویژگی‌ها / تنظیمات جدید | پشتیبانی از «هدف جذب مشتری جدید» در Google Ads API به‌روزرسانی شد تا طرح‌واره اهداف یکپارچه اصلاح‌شده را منعکس کند:
|
| تبدیل‌ها | ||
| ارجاع تبدیل طرف سوم YouTube | فیلدهای جدید | پشتیبانی از درستی‌سنجی اسناد تبدیل YouTube بااستفاده از شرکای طرف سوم اضافه شد:
|
| عمومی | ||
ContactDetails.phone_number_extension |
فیلد جدید | به منبع LocalServicesLead اضافه شد. |
IncentiveError |
مقادیر enum و خطاهای جدید | کدهای خطای خاص جدیدی برای ناموفق بودن پس‌خرید پاداش اضافه شده است:
|
| برنامه‌ریزی | ||
| جزئیات کانال YouTube در اطلاعات آماری پرطرفدار | فیلدهای جدید | پشتیبانی از جزئیات بیشتر کانال YouTube برای ویدیوهای مرتبط هنگام جستجوی اطلاعات آماری پرطرفدار اضافه شد. فیلدهای جدید channel_id، channel_name، و channel_url به YouTubeVideoAttributeMetadata اضافه شد. |
YouTubeChannelInsights.data_sharing_consent_given |
فیلد جدید | به YouTubeChannelInsights اضافه شد. این درصورتی درست است که محتواساز با هم‌رسانی داده‌های غیرعمومی موافقت کرده باشد. اگر این‌طور باشد، فیلدهای زیر پر می‌شوند:
|
| گزارش‌ها | ||
ad_sub_format_type |
بخش جدید | تفکیک آگهی‌های ردنشدنی درون جاری‌سازی YouTube را براساس مدت‌زمان ارائه می‌دهد:
ad_format_type انتخاب شود. با AdGroup، AdGroupAd، Campaign، Customer، Video، و VideoEnhancement قابل‌انتخاب است.
|
| سنجه‌های اجتماعی مختص ویدیو | فیلدها / سنجه‌های جدید | سنجه‌های اجتماعی مختص ویدیو اضافه شده است تا به آگهی‌دهندگان کمک کند تعامل کاربر (نظرات، پسندیدن‌ها، و هم‌رسانی‌ها) را برای آگهی‌های «کوته‌ویدیوها» در YouTube پیگیری کنند:
این زبان‌ها عبارتند از AdGroup، AdGroupAd، Asset، Campaign، Customer، و Video.
|
نسخه‌های اصلی و فرعی v24
Google Ads API v24 شامل ویژگی‌های جدید، به‌روزرسانی‌ها، و تغییرات اساسی زیر است.
نسخه ۲۴.۲ (۲۰۲۶/۰۶/۲۴)
ویژگی‌ها و به‌روزرسانی‌های جدید زیر در Google Ads API نسخه ۲۴.۲ اضافه شده است. نسخه‌های جزئی مثل v24.2 حاوی تغییرات اساسی نیستند.
| ویژگی‌ها و به‌روزرسانی‌ها | نوع | شرح |
|---|---|---|
| آگهی‌ها | ||
AssetAutomationType.GENERATE_LANDING_PAGE_TEXT |
مقدار شمارشی جدید | اطلاعات نوشتاری را از صفحه مقصد تولید می‌کند تا در پانل تعامل برای نمونه‌های DemandGenVideoResponsiveAd (که به‌طور پیش‌فرض از این نسخه میانای برنامه‌سازی کاربردی موافقت کرده‌اند) نشان داده شود. |
| دارایی‌ها | ||
AssetGroup.google_local_services_info |
فیلد جدید | برای پشتیبانی از اطلاعات «آگهی‌های خدمات محلی» (شناسه دسته و توضیحات) در پویش‌های «عملکرد بیشینه» اضافه شده است. |
AssetGroupSignal.local_services_id |
فیلد جدید | برای پشتیبانی از نشان‌های شناسه سرویس «آگهی‌های خدمات محلی» در پویش‌های «عملکرد بیشینه» اضافه شده است. |
AssetGroupSignal.vertical_ads_item_group_rule_list |
فیلد جدید | برای پشتیبانی از قوانین گروه موردهای آگهی‌های عمودی برای انتخاب موردها از فیدهای عمودی پیوست‌شده در پویش‌های «عملکرد بیشینه» اضافه شده است. این ویژگی فقط برای حساب‌های موجود در فهرست مجاز دردسترس است. |
AssetGroupErrorEnum.CANNOT_REMOVE_ALL_ASSET_GROUPS_FROM_CAMPAIGN |
مقدار enum جدید / خطا | هنگام تلاش برای برداشتن همه گروه‌های دارایی از پویش برگردانده می‌شود. |
AssetGroupSignalErrorEnum.CANNOT_REMOVE_ALL_SIGNALS |
مقدار enum جدید / خطا | هنگام تلاش برای برداشتن همه سیگنال‌ها از گروه دارایی برگردانده می‌شود. |
| پویش‌ها | ||
Campaign.PmaxCampaignSettings.local_services_pmax_campaign_settings Campaign.PmaxCampaignSettings.local_services_enabled |
فیلدهای جدید | پشتیبانی از شناسایی پویش‌های «عملکرد بیشینه» در «خدمات محلی». |
AdGroup.DemandGenAdGroupSettings.DemandGenChannelControls.DemandGenSelectedChannels.maps |
فیلد جدید | Google Maps را در کانال‌های قابل‌انتخاب برای گروه‌های آگهی «تولید تقاضا» اضافه می‌کند. |
CampaignCriterionErrorEnum.CANNOT_REMOVE_ALL_LOCATIONS_FROM_LOCAL_SERVICES_PMAX_CAMPAIGN |
مقدار enum جدید / خطا | وقتی تلاش می‌شود همه مکان‌ها از پویش «عملکرد بیشینه» خدمات محلی برداشته شود، این خطا برگردانده می‌شود. |
SmartCampaignErrorEnum.CREATION_FAILED |
مقدار enum جدید / خطا | هنگام تلاش برای ایجاد «کمپین‌های هوشمند» جدید برگردانده می‌شود. |
| تبدیل‌ها | ||
ConversionOrigin.LOCAL_SERVICES_ADS ConversionActionType.LOCAL_SERVICES_ADS |
مقادیر شمارشی جدید | نشان‌دهنده تبدیل‌هایی است که وقتی کاربر روی آگهی خدمات محلی کلیک می‌کند و با تبلیغ‌کننده تماس می‌گیرد، پیام می‌فرستد، یا رزرو می‌کند اتفاق می‌افتد. |
| آزمایش‌ها | ||
COMPARE_CAMPAIGNS PMAX_TEXT_CUSTOMIZATION_FINAL_URL_EXPANSION |
مقادیر شمارشی جدید | پشتیبانی از انواع جدید ExperimentType اضافه شد:
|
| عمومی | ||
Asset.synthetic_content_info Ad.synthetic_content_info |
فیلدهای جدید | حاوی گواهی‌های مربوط به محتوای مصنوعی/هوشواره‌ای است که به دو بخش advertiser_attestation (اظهارنامه‌هایی که مستقیماً توسط تبلیغ‌کننده ارائه شده است) و system_attestation (گواهی‌هایی که به‌طور خودکار توسط سیستم شناسایی یا ارائه شده است) تقسیم می‌شود.
این ویژگی به نسخه‌های ۲۳ و ۲۲ منتقل شده است.
برای کمک به شما در برنامه‌ریزی کار ادغام آتی برای نسخه ۲۵، میانای
تغییر فیلدهای گواهی تبلیغ‌کننده زودتر برای نسخه ۲۲ و بالاتر
معرفی می‌شود. میانای کاربری در این نسخه‌ها قابل‌مشاهده است، اما
اگر درخواست تغییر را در هریک از این فیلدها امتحان کنید، یکی از این خطاها برگردانده خواهد شد: «فیلدی که تلاش شده تغییر کند تغییرناپذیر است» یا «فیلد را نمی‌توان تنظیم کرد». این فیلدها از نسخه ۲۵ کاملاً قابل‌تغییر خواهند شد. توصیه می‌کنیم اکنون از این میانای کاربری برای ساختن و آزمایش کردن منطق داخلی‌تان استفاده کنید تا سیستمتان برای قابلیت‌های کامل نوشتن هنگام راه‌اندازی نسخه ۲۵ آماده باشد. |
| مجوزدهی چندطرفی | ویژگی‌های جدید |
پشتیبانی از بازبینی‌های «مجوزدهی چندطرفی» (MPA) اضافه شد:
این ویژگی به v23.3، v22.2، و v21.2 منتقل شده است. |
IncentiveService.FetchIncentive |
تغییر رفتاری | وقتی نشانی ایمیل نامعتبری در درخواست ارائه می‌شود، این روش اکنون به‌جای ایجاد خطای AuthenticationError.INVALID_EMAIL_ADDRESS، به‌طور مناسب به برگرداندن پیشنهادهای تشویقی پیش‌فرض برمی‌گردد. |
| برنامه‌ریزی | ||
GenerateCreatorInsightsRequest.search_topics |
فیلد جدید | به سرویس ContentCreatorInsightsService.GenerateCreatorInsights اضافه شد. این گزینه محتواسازانی را جستجو می‌کند که درباره موضوعی در کشور مشخص‌شده در country_locations صحبت می‌کنند (فقط از جستجو برای یک کشور پشتیبانی می‌کند). |
CREATOR_TOPIC_INSIGHTS |
مقدار شمارشی جدید | به InsightsKnowledgeGraphEntityCapabilities اضافه شد تا نهادهایی را برای جستجوی محتواسازانی که درباره موضوعی صحبت می‌کنند نشان دهد. این نهادها باید در فیلد search_topics استفاده شوند. بااستفاده از AudienceInsightsService.ListAudienceInsightsAttributes بازیابی شد. |
KnowledgeGraphEntitySearchOptions |
نوع / گزینه‌های جدید | حاوی گزینه‌های جستجوی اضافی برای موضوعات در ListAudienceInsightsAttributes، ازجمله گزینه‌هایی برای بازیابی همه موضوعات پشتیبانی‌شده به‌عنوان مشخصه‌های محتواساز، و فیلتر کردن براساس قابلیت‌ها. |
GenerateCreatorInsightsRequest.supplemental_data GenerateTrendingInsightsRequest.supplemental_data |
فیلدهای جدید | ورودی‌های اختیاری برای روش‌های ContentCreatorInsightsService. با ارائه این فیلد، مکان‌های اضافی یا مشخصه‌های محتواساز در پاسخ تکمیل می‌شود. |
local_creator_insights related_local_creators |
فیلدهای جدید | وقتی supplemental_data حاوی شمارش LOCAL_CREATOR_DATA باشد، تکمیل می‌شود. محتواسازان محلی را که در کشور انتخاب‌شده مشاهده شده‌اند یا در آنجا مستقر هستند و با هم‌رسانی داده‌های مکان موافقت کرده‌اند نشان می‌دهد. |
GenerateTrendingInsightsRequest.sub_country_locations |
فیلد جدید | به ContentCreatorInsightsService.GenerateTrendingInsights اضافه شد، که امکان جستجوی اطلاعات آماری پرطرفدار را بااستفاده از مکان کشور و مکان‌های فرعی کشور فراهم می‌کند. |
| گزارش‌ها | ||
PerformanceMaxPlacementView |
افزونه بخش‌ها | توسط ad_network_type قابل‌بخش‌بندی شد. |
| خرید | ||
Campaign.ShoppingSetting.ignore_brand_exclusion_in_shopping_ads |
فیلد جدید | اگر درست باشد، مستثنا کردن‌های نمانام برای آگهی‌های «آماده خرید» نادیده گرفته می‌شود. فقط برای پویش‌های Shopping پشتیبانی می‌شود. |
| هدف‌گیری | ||
CriterionErrorEnum.CANNOT_TARGET_LANGUAGE |
مقدار enum جدید / خطا | وقتی تلاش می‌شود زبانی هدف‌یابی شود که مجاز نیست، این خطا برگردانده می‌شود. |
| ویدیوها | ||
DataLink.youtube_link_metadata |
فیلد جدید | حاوی brand_channel_id برای مشخص کردن شناسه کانال نمانام YouTube پیوندشده است. |
نسخه ۲۴.۱ (۲۰۲۶/۰۵/۱۳)
ویژگی‌ها و به‌روزرسانی‌های جدید زیر در Google Ads API نسخه ۲۴.۱ اضافه شده است. نسخه‌های جزئی مثل v24.1 حاوی تغییرات اساسی نیستند.
| ویژگی‌ها و به‌روزرسانی‌ها | نوع | شرح |
|---|---|---|
| آگهی‌ها | ||
DemandGenMultiAssetAdInfo.classic_display_images |
فیلد جدید | تصاویر نمایشی بارگذاری‌شده سفارشی بدون نیاز به دارایی‌های واکنش‌گرای اضافی ارائه می‌شوند. |
| آزمایش‌ها | ||
ADOPT_AI_MAX ADOPT_BROAD_MATCH_KEYWORDS OPTIMIZE_ASSETS PMAX_REPLACEMENT_SHOPPING |
مقادیر شمارشی جدید | پشتیبانی از انواع جدید ExperimentType اضافه شد:
|
Experiment.video_experiment |
فیلد جدید | پشتیبانی پیکربندی برای آزمایش‌های YOUTUBE_CUSTOM موجود شامل «پویش‌های ویدیویی». |
ExperimentArm.asset_testing_info ExperimentArm.asset_groups ExperimentArm.performance_max_experiment_arm_info |
فیلدهای جدید | فیلدهایی را برای پشتیبانی از آزمایش دارایی، گروه‌های دارایی، و تنظیمات «عملکرد بیشینه» در بازوهای آزمایش نشان می‌دهد:
|
| عمومی | ||
CustomerUserAccess.passkey_enabled |
فیلد جدید | فیلد فقط خواندنی که نشان می‌دهد آیا کاربر گذرکلید را فعال کرده است یا نه. |
| گزارش‌ها | ||
mobile_device_platform |
بخش جدید | امکان بخش‌بندی گزارش‌ها براساس پلاتفرم دستگاه کاربر (مانند iOS یا Android) را فراهم می‌کند. |
REQUESTED_DATE_GRANULARITY_NOT_SUPPORTED |
مقدار enum جدید / خطا | زمانی برگردانده می‌شود که سطح جزئیات زمانی روزانه، ساعتی، یا هفتگی درخواست‌شده برای محدوده‌های تاریخ پُرسمان پشتیبانی نشود (فقط برای ۳۷ ماه گذشته دردسترس است). |
vertical_ads_listing_user_rating vertical_ads_listing_venue |
بخش‌های جدید | بخش‌های جدیدی که برای آگهی‌های عمودی استفاده می‌شود. |
user_rating، venue، event_participant_display_name |
معیار فیلتر جدید | فیلتر کردن در VerticalAdsItemGroupRuleInfo برای منبع SharedCriterion پشتیبانی می‌شود. |
| سنجه‌های آزمایش کنترل/درمان | فیلدهای جدید | مقادیر کنترل (control_clicks، و غیره)، مقادیر درمان (clicks، و غیره)، برآوردهای نقطه‌ای (clicks_point_estimate، و غیره)، حاشیه‌های خطا (clicks_margin_of_error، و غیره)، و مقادیر p (clicks_p_value، و غیره) در هفت خانواده سنجه اصلی (کلیک‌ها، ظهورها، هزینه، تبدیل‌ها، تبدیل‌بها، مقدار تبدیل، مقدار تبدیل به‌ازای هزینه) اضافه شد. |
| سنجه‌های تغییر مطلق تبدیل‌ها | فیلدهای جدید | پشتیبانی از Conversions برآوردهای تفاوت مطلق بااستفاده از برآورد نقطه‌ای، حاشیه خطا، و فیلدهای مقدار p. |
| هدف‌گیری | ||
CriterionErrorEnum.CANNOT_EXCLUDE_ALL_TARGETS |
مقدار enum جدید / خطا | هنگام تلاش برای مستثنی کردن همه هدف‌های جمعیت‌شناسی برگردانده می‌شود. |
| ویدیوها | ||
ThirdPartyViewabilityIntegrationPartnerEnum.ZEFR |
مقدار شمارشی جدید | ZEFR به‌عنوان شریک ادغام قابلیت مشاهده شخص ثالث منتشر شد. |
DataLink.youtube_video.channel_id |
فیلد جدید | شناسه کانال YouTube مرتبط با پیوند داده را نشان می‌دهد. |
نسخه ۲۴ (۲۰۲۶/۰۴/۲۲)
ویژگی‌های جدید، به‌روزرسانی‌ها، و تغییرات اساسی زیر در Google Ads API نسخه ۲۴ که یک نسخه اصلی است اضافه شده است.
برای راهنمایی، ارتقا به جدیدترین نسخه را ببینید.
تغییرات ناسازگار
| حالت اولیه | ایالت جدید | نوع تغییر | راهنمای پیاده‌سازی |
|---|---|---|---|
| آگهی‌ها | |||
videos و logo_images اختیاری در DemandGenVideoResponsiveAdInfo |
قسمت‌های الزامی | تغییر رفتاری | هنگام ایجاد یا تغییر آگهی‌های ویدیویی واکنش‌گرای «تولید تقاضا»، videos و logo_images را ارائه دهید. |
videos، business_name، و logo_images اختیاری در VideoResponsiveAdInfo |
قسمت‌های الزامی | تغییر رفتاری | هنگام ایجاد یا تغییر آگهی‌های واکنش‌گرای ویدیویی، videos، business_name، و logo_images را ارائه دهید. توجه داشته باشید که VideoResponsiveAdInfo اکنون قابل‌تغییر است. |
| پویش‌ها | |||
Campaign.video_brand_safety_suitability |
هیچ‌کدام | برداشتن | کنترل مناسب بودن در سطح پویش برداشته شده است. مناسب بودن ایمنی نمانام هنوز در سطح مشتری دردسترس است. درعوض از Customer.video_brand_safety_suitability استفاده کنید. |
| تبدیل‌ها | |||
UserListCustomerTypeCategoryEnum.LOYALTY_SIGN_UPS |
هیچ‌کدام | برداشتن | دسته کاربری ثبت‌نام‌های وفاداری برداشته شده است. ارجاع‌های کد به آن را بردارید. |
| برنامه‌ریزی | |||
نوع InsightsAudienceAttributeGroup برای topic_audience_combinations |
نوع common.InsightsAudienceAttributeGroup |
تغییر رفتاری / تغییر نوع | ادغام‌های کتابخانه‌های مشتری تایپ‌شده باید به‌روزرسانی شوند تا از فضاهای نام منبع جدید استفاده کنند. |
فیلد youtube_select_lineups در ReachPlanService.ListPlannableProducts |
هیچ‌کدام | برداشتن | به استفاده از فهرست‌های youtube_select_lineup_targeting بروید. |
فیلد is_brand_connect_creator در ContentCreatorInsightsService.GenerateCreatorInsights و GenerateTrendingInsights |
هیچ‌کدام | برداشتن | درعوض، بررسی کنید که آیا محتواساز CREATOR_PARTNERSHIPS را در partnership_opportunities دردسترس دارد یا نه. |
geo_modifiers و biddable_keywords در KeywordPlanIdeaService.GenerateKeywordForecastMetrics |
geo_target_constants و keywords |
تغییر نام / برداشتن | با CampaignToForecast.geo_target_constants[] و ForecastAdGroup.keywords[] جایگزین شد. |
فیلدهای پیش‌بینی / طرح کلیدواژه‌های منسوخ در GenerateKeywordForecastMetrics |
هیچ‌کدام | برداشتن | فیلدها و انواع طرح / پیش‌بینی زیر برداشته شد: ادغام‌ها را براساس آن به‌روز کنید. |
| گزارش‌ها | |||
ad_sub_network_type بخش در campaign_budget |
هیچ‌کدام | برداشتن | بخش ad_sub_network_type برای منبع campaign_budget برداشته شد. |
بخش click_type در نماهای دارایی |
هیچ‌کدام | برداشتن | بخش از نماهای AdGroupAsset، CampaignAsset، و CustomerAsset برداشته شد. |
| ویدیوها | |||
در ShareablePreviewService.GenerateShareablePreviews، موارد ناقص ناموفق مجاز است |
بدون نقص جزئی | تغییر رفتاری | اگر هرکدام از شناسه‌های موجود در درخواست اعتبارسنجی نشود، درخواست ناموفق خواهد بود و خطا نشان داده می‌شود. |
ShareablePreviewError کدهای قدیمی:
|
MutateErrorEnum.RESOURCE_NOT_FOUND ShareablePreviewError.TOO_MANY_RESOURCES_IN_REQUEST |
تغییر نام / تغییر رفتاری | کدهای خطای برگردانده‌شده برای گروه‌های دارایی اصلاح شده‌اند تا با خطاهای آگهی گروه آگهی مطابقت داشته باشند. Update validation catch logic. |
ویژگی‌ها و به‌روزرسانی‌ها (غیرمخرب)
| ویژگی‌ها و به‌روزرسانی‌ها | نوع | شرح |
|---|---|---|
| آگهی‌ها | ||
تغییرپذیری VideoResponsiveAdInfo |
تغییر رفتاری | اشیاء اطلاعات آگهی‌های ویدیویی واکنش‌گرا اکنون قابل‌تغییر هستند. |
| دارایی‌ها | ||
travel_feed_data در AssetSet |
فیلد جدید | برای بازیابی مشخصه‌های دارایی‌های فید سفر (hotel_center_account_id، merchant_center_id، partner_center_id، subset_id، travel_feed_vertical_type) اضافه شد. |
| پویش‌ها | ||
Campaign.view_through_conversion_optimization_enabled |
فیلد جدید | امکان فعال کردن «بهینه‌سازی تبدیل بازدیدِ گذری» (VTC) (پیش‌فرض false) را در پویش‌های «تولید تقاضا» و «برنامه» فراهم می‌کند. |
CampaignCriterion.gender |
ویژگی جدید | کنارگذاری‌های جنسیتی برای پویش‌های «عملکرد بیشینه» در همه نسخه‌های Google Ads API فعال شد. |
| تبدیل‌ها | ||
| انواع تبدیل «تولید مشتری بالقوه» | مقادیر شمارشی جدید | انواع شمارشی کنش تبدیل GA4/Firebase جدید در ConversionActionType اضافه شد:
|
| عمومی | ||
UserListErrorEnum.DUPLICATE_LOOKALIKE |
مقدار enum جدید / خطا | هنگام تلاش برای ایجاد چند فهرست مشابه یکسان برگردانده می‌شود. |
| برنامه‌ریزی | ||
ProductCoreAttributes فیلد در ListPlannableProductsResponse |
فیلدهای جدید | شرح محصول قابل‌برنامه‌ریزی، هدف بازاریابی، مدل هزینه، و روش خرید به ProductCoreAttributes در ListPlannableProductsResponse اضافه شد. |
| گزارش‌ها | ||
CartDataSalesView |
منبع گزارش جدید | گزارش‌هایی را نشان می‌دهد که سنجه‌های تبدیل را علاوه‌بر محصول کلیک‌شده، براساس محصول خاص فروخته‌شده (نمانام و غیره) بخش‌بندی می‌کند. |
| سنجه‌های غیرقابل پیشنهاد قیمت دادنی | فیلدهای جدید | سنجه‌های غیرقابل پیشنهاد قیمت (سنجه‌هایی که تبدیل‌هایی را نشان می‌دهند که پویش‌ها برای آن‌ها بهینه‌سازی نمی‌شوند) به همه منابع منطبق اضافه شد:
|
conversion_attribution_event_type |
بخش جدید | به ShoppingPerformanceView اضافه شد. |
| خرید | ||
کمپین‌های برنامه در ShoppingProduct |
ویژگی جدید | پویش‌های «برنامه» پشتیبانی‌شده در منبع ShoppingProduct. وضعیت یادداشت و مشکلات پشتیبانی نمی‌شود. |
| فیلتر کردن محصول براساس برچسب | ویژگی جدید | فیلتر کردن بااستفاده از عبارت‌های مجموعه منطقی به‌صورت پویا معرفی شد:
|
نسخه‌های اصلی و فرعی v23
Google Ads API v23 شامل ویژگی‌های جدید، به‌روزرسانی‌ها، و تغییرات اساسی زیر است.
نسخه ۲۳.۳ (۲۰۲۶/۰۶/۲۴)
ویژگی‌ها و به‌روزرسانی‌های جدید زیر در Google Ads API نسخه ۲۳.۳ اضافه شده است. نسخه‌های جزئی مثل v23.3 حاوی تغییرات ناسازگار نیستند.
| ویژگی‌ها و به‌روزرسانی‌ها | نوع | شرح |
|---|---|---|
| عمومی | ||
Asset.synthetic_content_info Ad.synthetic_content_info |
فیلدهای جدید | حاوی گواهی‌های محتوای مصنوعی/تولیدشده با هوش مصنوعی است که به advertiser_attestation (اظهارنامه‌هایی که مستقیماً توسط تبلیغ‌کننده ارائه شده است) و system_attestation (گواهی‌هایی که به‌طور خودکار توسط سیستم‌های Google شناسایی یا ارائه شده است) تقسیم می‌شود.
برای کمک به شما در برنامه‌ریزی کار ادغام آتی برای نسخه ۲۵، میانای
تغییر فیلدهای گواهی تبلیغ‌کننده زودتر برای نسخه ۲۲ و بالاتر
معرفی می‌شود. میانای کاربری در این نسخه‌ها قابل‌مشاهده است، اما
اگر درخواست تغییر را در هریک از این فیلدها امتحان کنید، یکی از این خطاها برگردانده خواهد شد: «فیلدی که تلاش شده تغییر کند تغییرناپذیر است» یا «فیلد را نمی‌توان تنظیم کرد». این فیلدها از نسخه ۲۵ کاملاً قابل‌تغییر خواهند شد. توصیه می‌کنیم اکنون از این میانای کاربری برای ساختن و آزمایش کردن منطق داخلی‌تان استفاده کنید تا سیستمتان برای قابلیت‌های کامل نوشتن هنگام راه‌اندازی نسخه ۲۵ آماده باشد. |
| تأییدیه‌های چندجانبه | ویژگی‌های جدید |
پشتیبانی از مرورهای تأیید چندجانبه (MPA) اضافه شد:
|
نسخه ۲۳.۲ (۲۰۲۶/۰۳/۲۵)
ویژگی‌ها و به‌روزرسانی‌های جدید زیر در Google Ads API نسخه ۲۳.۲ اضافه شده است. نسخه‌های جزئی مثل v23.2 حاوی تغییرات ناگهانی نیستند.
| ویژگی‌ها و به‌روزرسانی‌ها | نوع | شرح |
|---|---|---|
| دارایی‌ها | ||
VideoEnhancement |
منبع جدید | حاوی اطلاعات آگهی ویدیویی مختص بهبود است، مثلاً اینکه Google آن را تولید کرده است یا تبلیغ‌کننده آن را ارائه کرده است. برای کسب اطلاعات بیشتر، درباره بهبودهای ویدیو را ببینید. |
AppTopCombinationView |
منبع جدید | منبع فقط خواندنی برای ارائه اطلاعات آماری درباره ترکیب‌های دارایی با عملکرد برتر در «پویش‌های برنامه». |
CustomerAsset |
ویژگی جدید | پشتیبانی برای بازیابی CustomerAsset با field_type تنظیم‌شده روی BUSINESS_LOGO اضافه شد. |
| پویش‌ها | ||
AdGroupAd.start_date_time AdGroupAd.end_date_time |
فیلدهای جدید | محدودیت‌های زمان‌بندی دقیق‌تری را برای تاریخ‌های پویش ارائه دهید. این ویژگی فقط برای برخی‌از انواع گروه‌های آگهی پشتیبانی می‌شود. |
HotelSettingInfo.disable_hotel_setting |
فیلد جدید | امکان غیرفعال کردن فید هتل در پویش‌های «تولید تقاضا» را فراهم می‌کند. |
| عمومی | ||
CustomerClientLinkError |
مقادیر / خطاهای شمارشی جدید | دو کد خطای جدید اضافه شد: MAX_CUSTOMER_LIMIT_REACHED و ACCOUNT_CREATION_POLICY_VIOLATION. |
UserListCustomerTypeCategoryEnum.LOYALTY_SIGN_UPS |
تغییر رفتاری | اکنون هنگام تلاش برای استفاده از این دسته نوع مشتری فهرست کاربر منسوخ‌شده، خطایی ایجاد می‌شود. |
| برنامه‌ریزی | ||
GenerateTrendingInsights GenerateCreatorInsights |
ویژگی‌های جدید | پشتیبانی از ترکیب‌های سفارشی «و/یا» برای نهادها، موضوعات، و مخاطبان اضافه شد. |
ReachPlanService.GenerateReachForecast |
مقادیر شمارشی جدید | گروه‌های سنی هدف‌گیری‌شدنی جدیدی مثل AGE_RANGE_21_44 یا AGE_RANGE_21_49 اضافه شده است. |
youtube_select_lineup_targeting |
فیلد جدید | به ReachPlanService.ListPlannableProducts اضافه شد، که جایگزین youtube_select_lineups خواهد شد. درحال‌حاضر هر دو فیلد پر شده است. |
ReachPlanSurface |
مقدار شمارشی جدید | IN_STREAM_NON_SKIPPABLE_THIRTY_SECONDS به‌عنوان گزینه جستجو اضافه شد. |
Forecast |
فیلد جدید | clicks برای «بیشینه‌سازی کلیک‌ها» (کلیک‌بها) در «تولید تقاضا» در ReachPlanService.GenerateReachForecast اضافه شد. |
partnership_opportunities |
فیلد جدید | به ContentCreatorInsightsService.GenerateCreatorInsights و ContentCreatorInsightsService.GenerateTrendingInsights اضافه شد. |
| گزارش‌ها | ||
biddable_indirect_install_first_in_app_conversion_micros |
فیلد جدید | به منابع Campaign، Customer، و AdGroup اضافه شد. |
| ویدیوها | ||
ShareablePreviewService |
ویژگی جدید | با تنظیم preview_type روی YOUTUBE_LIVE_PREVIEW، برای پشتیبانی از پیش‌نمایش‌های «پخش زنده YouTube» گسترش یافته است. UNSUPPORTED_AD_TYPE و TOO_MANY_RESOURCES_IN_REQUEST به ShareablePreviewError اضافه شد. این ویژگی فقط برای برخی‌از انواع آگهی‌ها پشتیبانی می‌شود. |
نسخه ۲۳.۱ (۲۰۲۶/۰۲/۲۵)
ویژگی‌ها و به‌روزرسانی‌های جدید زیر در Google Ads API نسخه ۲۳.۱ اضافه شده است. نسخه‌های جزئی مثل v23.1 حاوی تغییرات ناگهانی نیستند.
| ویژگی‌ها و به‌روزرسانی‌ها | نوع | شرح |
|---|---|---|
| مدیریت حساب | ||
advertising_partner_properties.allowed_domain |
فیلد جدید | به منابع ProductLinkInvitation و ProductLink اضافه شد. شریک تبلیغاتی فقط می‌تواند در این دامنه تبلیغ کند. |
Customer.contains_eu_political_advertising |
فیلد جدید | وضعیت اظهارنامه سطح حساب را درباره اینکه آیا حاوی تبلیغات سیاسی هدف‌یابی‌شده برای اتحادیه اروپا است یا نه بازیابی می‌کند و EuPoliticalAdvertisingStatus را برمی‌گرداند. |
| پویش‌ها | ||
Campaign.text_guidelines |
فیلد جدید | پشتیبانی از دستورالعمل‌های نوشتاری اضافه شد که می‌توان از آن در پویش‌های «بیشینه‌سازی عملکرد» و «شبکه جستجو» برای کنترل برنامه‌ای دارایی‌های نوشتاری تولیدشده با هوش مصنوعی استفاده کرد. در text_guidelines، می‌توانید term_exclusions و messaging_restrictions را تعریف کنید. |
CampaignPrimaryStatusReason |
مقادیر شمارشی جدید | CAMPAIGN_NOT_BOOKED، BOOKING_HOLD_EXPIRING، BOOKING_HOLD_EXPIRED، و BOOKING_CANCELLED اضافه شد تا دلایل وضعیت اصلی برای پویش‌های دارای استراتژی پیشنهاد قیمت FIXED_CPM ارائه شود. |
Campaign.VideoCampaignSettings.reservation_ad_category_self_disclosure Campaign.VideoCampaignSettings.booking_details |
فیلدهای جدید | پشتیبانی از شفاف‌سازی خودکار دسته آگهی مدل رزرو و جزئیات رزرو فقط خواندنی اضافه شد. |
Campaign.missing_eu_political_advertising_declaration |
فیلد جدید | از پُرسمان و فیلتر کردن پویش‌هایی که فاقد اظهارنامه درباره اینکه آیا حاوی تبلیغات سیاسی هدف‌یابی‌شده برای اتحادیه اروپا هستند یا نه پشتیبانی می‌کند. |
| تبدیل‌ها | ||
ConversionActionCategory.YOUTUBE_FOLLOW_ON_VIEWS |
مقدار شمارشی جدید | از ردیابی کاربرانی که آگهی را تماشا می‌کنند و بعداً ویدیویی را از همان کانال تماشا می‌کنند پشتیبانی می‌کند. |
| عمومی | ||
CriterionErrorEnum.CANNOT_TARGET_ONLY_UNDETERMINED |
مقدار enum جدید / خطا | وقتی برگردانده می‌شود که تلاش شود فقط دسته نامشخص در ابعاد جمعیت‌شناسی هدف‌یابی شود. |
| مشوق‌ها | ||
IncentiveErrorEnum |
مقادیر / خطاهای شمارشی جدید | دو کد خطای جدید اضافه شد: MAX_INCENTIVES_REDEEMED و ACCOUNT_TOO_OLD. این خطاها ممکن است برای درخواست‌های انجام‌شده در ۱۱ مارس ۲۰۲۶ یا پس‌از آن برگردانده شود. |
| برنامه‌ریزی | ||
GenerateBenchmarksMetrics |
ویژگی جدید | پشتیبانی از تفکیک تاریخ بااستفاده از BreakdownDefinition اضافه شد. |
ReachPlanService.GenerateReachForecast |
مقدار شمارشی جدید | GOOGLE_DISPLAY_NETWORK به‌عنوان سطح قابل‌هدف‌یابی برای «بیشینه‌سازی تبدیل‌های تولید تقاضا» اضافه شد. |
GenerateTrendingInsights |
فیلدهای جدید | اطلاعات خط روند تاریخی در TrendInsightDataPoint تا TrendInsights هنگام جستجو براساس موضوع اضافه شد. |
| گزارش‌ها | ||
| سنجه‌های بسامد کاربر متمایز | فیلدهای جدید | سنجه‌های جدیدی اضافه شده است که گزارش می‌دهد چند کاربر آگهی شما را حداقل دو، سه، چهار، پنج، یا ده بار دیده‌اند: unique_users_two_plus، unique_users_three_plus، unique_users_four_plus، unique_users_five_plus، و unique_users_ten_plus. |
SearchTermMatchSource |
مقدار شمارشی جدید | VERTICAL_ADS_DATA_FEED برای پشتیبانی از فیدهای داده آگهی عمودی، مثل هدف‌یابی نهاد «آگهی‌های سفر»، اضافه شد. |
| YouTubeVideoUpload | ||
YouTubeVideoUpload |
سرویس / منبع جدید | سرویس YouTubeVideoUpload برای پشتیبانی از بارگذاری و مدیریت ویدیوها در YouTube و منبع YouTubeVideoUpload برای پشتیبانی از واکشی وضعیت بارگذاری و فراداده اضافه شد. این ویژگی فقط برای REST و کتابخانه کارخواه Python پشتیبانی می‌شود. |
نسخه ۲۳ (۲۰۲۶/۰۱/۲۸)
ویژگی‌های جدید، به‌روزرسانی‌ها، و تغییرات اساسی زیر در Google Ads API نسخه ۲۳ که نسخه اصلی است اضافه شده است.
برای راهنمایی، ارتقا به جدیدترین نسخه را ببینید.
تغییرات ناسازگار
| حالت اولیه | ایالت جدید | نوع تغییر | راهنمای پیاده‌سازی |
|---|---|---|---|
| آگهی‌ها | |||
| هم‌رسانی آگهی مجاز است | AdGroupAdError.AD_SHARING_NOT_ALLOWED |
تغییر رفتاری | هم‌رسانی آگهی بین چند گروه آگهی دیگر مجاز نیست. درخواست‌هایی که برای هم‌رسانی آگهی‌ها تلاش می‌کنند خطای AD_SHARING_NOT_ALLOWED را برمی‌گردانند. |
پشتیبانی از CallAd و CallAdInfo |
هیچ‌کدام | برداشتن | پشتیبانی از آگهی‌های تماسی برداشته شده است. به مقاله مرکز راهنمایی درباره آگهی‌های تماس مراجعه کنید. |
| پویش‌ها | |||
Campaign.start_date Campaign.end_date |
Campaign.start_date_time Campaign.end_date_time |
تغییر نام / جایگزینی | از فیلدهای جدید تاریخ-زمان برای مشخص کردن مؤلفه‌های زمان برای پویش‌ها استفاده کنید. فیلدهای اصلی فقط تاریخ برداشته می‌شوند. |
| افزایش تقاضا | |||
DemandGenMultiAssetAdInfo.lead_form_only |
هیچ‌کدام | برداشتن | فیلد lead_form_only برداشته شده است. مرجع‌ها را در کدتان به‌روز کنید. |
| گزارش‌ها | |||
| سنجه‌های برچسب عملکرد دارایی انبوهشی و شمارشی | هیچ‌کدام | برداشتن | سنجه‌های برچسب عملکرد دارایی انبوه حذف شد. شمارش برچسب عملکرد دیگر برای «جستجو» و «شبکه تبلیغات» برگردانده نمی‌شود. |
ویژگی‌ها و به‌روزرسانی‌ها (غیرمخرب)
| ویژگی‌ها و به‌روزرسانی‌ها | نوع | شرح |
|---|---|---|
| آگهی‌ها | ||
AdFormatType |
مقادیر شمارشی جدید | انواع قالب جدید اضافه شد: TEXT، VERTICAL_ADS_BOOKING_LINK، و VERTICAL_ADS_PROMOTION. |
| دارایی‌ها | ||
asset_group بازدید |
فیلدهای جدید | سنجه‌های زیر اضافه شد: metrics.engagements، metrics.engagement_rate، و metrics.average_cpe. |
asset_group_asset بازدید |
فیلدهای جدید | سنجه‌های زیر اضافه شد: metrics.average_cpe، metrics.average_cpm، metrics.trueview_average_cpv، metrics.video_trueview_view_rate، metrics.video_trueview_views، و metrics.interaction_event_types. |
Asset.orientation |
فیلد جدید | فیلد جهت‌گیری فقط خواندنی به دارایی‌های تصویر و ویدیو اضافه شد. |
CampaignAsset |
ویژگی جدید | پشتیبانی برای بازیابی دارایی‌های پویش با field_type تنظیم‌شده روی HEADLINE و DESCRIPTION اضافه شد. |
ServedAssetFieldType |
مقادیر شمارشی جدید | HEADLINE_AS_SITELINK_POSITION_ONE، HEADLINE_AS_SITELINK_POSITION_TWO، DESCRIPTION_LINE_HEADLINE_AS_SITELINK_POSITION_ONE، و DESCRIPTION_LINE_HEADLINE_AS_SITELINK_POSITION_TWO برای دارایی‌هایی که به‌عنوان سایت‌پیوند ارائه می‌شوند اضافه شد. |
BusinessMessageAsset |
ویژگی‌های جدید / پشتیبانی | دارایی‌های «پیام کاری» به‌روزشده:
|
| صورت‌حساب | ||
InvoiceService.ListInvoices |
گزینه‌های جدید | اکنون می‌تواند با تنظیم کردن include_granular_level_invoice_details در ListInvoicesRequest، جزئیات دقیق‌تری را در Invoice برگرداند، ازجمله تفکیک هزینه در سطح پویش، هزینه‌های نظارتی تفکیک‌شده، و اطلاعات اصلاحیه. |
RegulatoryFeeType UnitOfMeasure |
شمارش‌های جدید | شمارش‌های کمکی برای کارمزدهای نظارتی و واحدهای اندازه‌گیری اضافه شد. |
| پویش‌ها | ||
CampaignError |
مقادیر / خطاهای شمارشی جدید | کدهای خطای DURATION_TOO_LONG_FOR_TOTAL_BUDGET و END_DATE_TIME_REQUIRED_FOR_TOTAL_BUDGET اضافه شد. |
| تبدیل‌ها | ||
| ConversionActionCategory | مقدار شمارشی جدید | YOUTUBE_FOLLOW_ON_VIEWS برای پشتیبانی از ردیابی کاربرانی که آگهی را تماشا می‌کنند و بعداً ویدیویی را از همان کانال تماشا می‌کنند اضافه شد. |
| افزایش تقاضا | ||
DemandGenVideoResponsiveAdInfo.companion_banner |
فیلد جدید | پشتیبانی از برنماهای همراه در آگهی‌های ویدیویی واکنش‌گرای «تولید تقاضا» اضافه شد. |
| مشوق‌ها | ||
پشتیبانی از مشوق‌های «انتخاب با شما» (CYO) اضافه شد:
برای تسهیل رسیدگی برنامه‌ای دقیق‌تر به خطاها، در نسخه‌های پخش آتی کدهای خطای بیشتری به |
||
| برنامه‌ریزی | ||
AudienceInsightsDimension.LIFE_EVENT_USER_INTEREST |
مقدار شمارشی جدید | امکان ایجاد مخاطب بااستفاده از «رویدادهای زندگی» در GenerateAudienceCompositionInsights، GenerateSuggestedTargetingInsights، GenerateInsightsFinderReport، و GenerateCreatorInsights را فراهم می‌کند.
«رویدادهای زندگی» برای دیگر روش‌های |
ReachPlanService.GenerateConversionRates |
فیلدها / گزینه‌های جدید | اکنون پاسخ شامل سطوحی برای پشتیبانی از پیشنهادهای نرخ تبدیل براساس کنترل‌های سطح (مثلاً Gmail، Shorts) است. فقط برای کمپین‌های «تولید تقاضا» پشتیبانی می‌شود. |
LanguageDistribution |
فیلد / نوع جدید | به YouTubeChannelInsights اضافه شد تا جزئیات توزیع زبان را در محتوای کانال YouTube ارائه دهد. |
BenchmarksService |
سرویس جدید | داده‌های تبلیغات YouTube را با معیارهای صنعت مقایسه می‌کند. |
AudienceInsightsService.GenerateAudienceDefinition |
روش جدید | بااستفاده از هوش مصنوعی زایا، شرح نوشتاری آزاد مخاطب هدف را به مشخصه‌های مخاطب منطبق ترجمه می‌کند. |
YouTubeChannelInsights.relevance_score |
فیلد جدید | ارزیابی می‌کند که محتواساز چقدر برای موضوعی که براساس بازدیدها وزن‌دهی شده است مناسب است. |
TrendInsightMetrics.trend_change_percent |
فیلد جدید | نشان‌دهنده درصد تغییر در مقدار روند درطول دوره مقایسه است. |
| توصیه‌ها | ||
GenerateRecommendationsRequest |
فیلد جدید | is_new_customer اضافه شد. وقتی برای توصیه‌های CAMPAIGN_BUDGET روی true تنظیم شود، از مدلی استفاده می‌کند که برای مشتریان جدید بهینه‌سازی شده است (فقط برای مشتریانی که پویش ندارند توصیه می‌شود). |
| گزارش‌ها | ||
AdGroupAdAssetView |
پشتیبانی از ویژگی / سنجه‌های جدید | اکنون از سنجه‌های ظهور، عملکرد، و تبدیل برای RESPONSIVE_DISPLAY_AD پشتیبانی می‌کند. |
بخش ad_sub_network_type |
بخش جدید | تفکیک عملکرد جزئی را در شبکه آگهی ارائه می‌دهد. در ابتدا برای کمپین‌های «تولید تقاضا» در YouTube (درون‌جاری، درون‌فید، «کوته‌ویدیوها») دردسترس است. باید همراه با ad_network_type انتخاب شود. |
| گزارش‌دهی «عملکرد بیشینه» | ویژگی جدید | تفکیک نوع شبکه آگهی برای پویش‌های «عملکرد بیشینه» فعال شد. |
UserLocationView GeographicView |
پشتیبانی از بخش‌های جدید | سنجه‌های پشتیبانی بخش‌بندی‌شده براساس تاریخ تبدیل: conversions_by_conversion_date، all_conversions_by_conversion_date، conversions_value_by_conversion_date، all_conversions_value_by_conversion_date، value_per_conversions_by_conversion_date، value_per_all_conversions_by_conversion_date، cross_device_conversions_by_conversion_date، و cross_device_conversions_value_by_conversion_date. |
| بخش‌های آگهی‌های عمودی | بخش‌های جدید | بخش‌های زیر اضافه شد: vertical_ads_event_participant_display_names، vertical_ads_hotel_class، vertical_ads_listing، vertical_ads_listing_brand، vertical_ads_listing_city، vertical_ads_listing_country، vertical_ads_listing_region، vertical_ads_partner_account، و vertical_ads_vertical. |
PerStoreView MatchedLocationInterestView |
منابع گزارش‌دهی جدید | PerStoreView برای پُرسمان جزئیات مکان فروشگاه و MatchedLocationInterestView (برای پویش‌های AI Max) برای ارائه سنجه‌های عملکرد براساس مکان‌های جغرافیایی موردعلاقه اضافه شد. |
| خرید | ||
ShoppingPerformanceView |
پشتیبانی از سنجه‌های جدید | اکنون از سنجه‌های زیر که براساس تاریخ تبدیل بخش‌بندی شده‌اند پشتیبانی می‌کند: conversions_by_conversion_date، all_conversions_by_conversion_date، conversions_value_by_conversion_date، و value_per_conversions_by_conversion_date، value_per_all_conversions_by_conversion_date. |
ShoppingPerformanceView |
پشتیبانی از سنجه‌های جدید | پشتیبانی از این موارد اضافه شد: search_budget_lost_impression_share، search_rank_lost_impression_share، search_budget_lost_absolute_top_impression_share، و search_rank_lost_absolute_top_impression_share. |
ShoppingProduct.product_image_uri |
فیلد جدید | به ShoppingProduct اضافه شد. |
| آگهی‌های عمودی | ||
AdGroup.vertical_ads_format_setting |
فیلد جدید | امکان کنترل اینکه کدام قالب‌های آگهی می‌توانند در «پویش‌های جستجو» بااستفاده از فیدهای سفر ارائه شوند را فراهم می‌کند. |
AdGroupCriterion SharedCriterion |
فیلدها / معیارهای جدید | نوع معیار vertical_ads_item_group_rule_list به AdGroupCriterion و vertical_ads_item_group_rule به SharedCriterion اضافه شد تا هدف‌یابی گروه‌های مورد در پویش‌های «شبکه جستجو» با فیدهای سفر مجاز شود. |
| یکپارچه‌سازی فید داده‌های آگهی‌های عمودی | ویژگی جدید | اکنون می‌توانید فید داده‌های آگهی‌های عمودی را به پویش جستجویی که «بیشینه‌سازی هوشواره‌ای» را اجرا می‌کند متصل کنید تا آگهی‌های سفر پیوند رزرو و تبلیغ ملک را درکنار آگهی‌های نوشتاری نشان دهید. قالب‌ها را با vertical_ads_format_setting کنترل کنید و قوانین را بااستفاده از vertical_ads_item_group_rule تعریف کنید. گزارش‌دهی بخش براساس AdFormatType و ابعاد فید داده‌های آگهی‌های عمودی. |
| ویدیوها | ||
AdVideoAssetInfo.ad_video_asset_feature_control |
فیلد جدید | گزینه‌های کنترل ویژگی برای دارایی‌های آگهی ویدیویی اضافه شد. |
CampaignCriterionError |
مقدار enum جدید / خطا | کد خطای INVALID_VIDEO_LINEUP_ID اضافه شد. |
| سنجه‌های شنیداری YouTube | معیارهای سنجش جدید | سنجه‌های شنیداری برای آگهی‌های صوتی در YouTube اضافه شد که گزارش می‌دهد آیا آگهی شنیدنی بوده است یا نه و در چند ظهور، شنیداری قابل‌اندازه‌گیری بوده است. |
یادداشت‌های انتشار بایگانی‌شده
برای یادداشت‌های انتشار بایگانی‌شده، نسخه‌های منسوخ‌شده را ببینید.