احتیاط: شما در حال مشاهده اسناد رابط REST API هستید. اکثر کتابخانه های مشتری رسمی ما از gRPC استفاده می کنند. برای جزئیات بیشتر به
مقدمه REST مراجعه کنید.
Method: customers.suggestSmartCampaignBudgetOptions
پیشنهادات BudgetOption را برمی گرداند.
درخواست HTTP
POST https://googleads.googleapis.com/v17/customers/{customerId}:suggestSmartCampaignBudgetOptions
URL از دستور GRPC Transcoding استفاده می کند.
پارامترهای مسیر
پارامترها |
---|
customerId | string مورد نیاز. شناسه مشتری که گزینه های بودجه او پیشنهاد می شود. |
درخواست بدن
بدنه درخواست حاوی داده هایی با ساختار زیر است:
نمایندگی JSON |
---|
{
// Union field suggestion_data can be only one of the following:
"campaign": string,
"suggestionInfo": {
object (SmartCampaignSuggestionInfo )
}
// End of list of possible types for union field suggestion_data .
} |
فیلدها |
---|
suggestion_data فیلد اتحادیه مورد نیاز. برای اولین بار ایجاد کمپین از SuggestionInfo استفاده کنید، برای به روز رسانی های بعدی در BudgetOptions بر اساس یک کمپین از قبل ایجاد شده از آن کمپین استفاده کنید. suggestion_data تنها می تواند یکی از موارد زیر باشد: |
campaign | string مورد نیاز. نام منبع کمپین برای دریافت پیشنهاد. |
suggestionInfo | object ( SmartCampaignSuggestionInfo ) مورد نیاز. اطلاعات مورد نیاز برای دریافت گزینه های بودجه |
بدن پاسخگو
پیام پاسخ برای SmartCampaignSuggestService.SuggestSmartCampaignBudgetOptions
. بسته به اینکه آیا سیستم میتواند گزینهها را پیشنهاد کند، ممکن است همه گزینهها یا هیچکدام از آنها برگردانده شوند.
در صورت موفقیت آمیز بودن، بدنه پاسخ حاوی داده هایی با ساختار زیر است:
فیلدها |
---|
low | object ( BudgetOption ) اختیاری. کم هزینه ترین گزینه |
recommended | object ( BudgetOption ) اختیاری. گزینه بودجه پیشنهادی |
high | object ( BudgetOption ) اختیاری. بالاترین گزینه بودجه. |
محدوده مجوز
به محدوده OAuth زیر نیاز دارد:
-
https://www.googleapis.com/auth/adwords
برای اطلاعات بیشتر، بهOAuth 2.0 Overview .
گزینه بودجه
گزینه بودجه کمپین هوشمند.
نمایندگی JSON |
---|
{
"dailyAmountMicros": string,
"metrics": {
object (Metrics )
}
} |
فیلدها |
---|
dailyAmountMicros | string ( int64 format) مقدار بودجه، به ارز محلی برای حساب. مقدار به میکرو مشخص می شود که یک میلیون معادل یک واحد ارز است. |
metrics | object ( Metrics ) اگر اطلاعات کافی برای استخراج برآوردها وجود نداشته باشد، معیارهای مربوط به بودجه پیشنهادی ممکن است خالی باشد. |
معیارها
معیارهای عملکرد برای یک گزینه بودجه معین.
نمایندگی JSON |
---|
{
"minDailyClicks": string,
"maxDailyClicks": string
} |
فیلدها |
---|
minDailyClicks | string ( int64 format) حداقل کلیک روزانه تخمینی. |
maxDailyClicks | string ( int64 format) حداکثر کلیک روزانه تخمینی. |
جز در مواردی که غیر از این ذکر شده باشد،محتوای این صفحه تحت مجوز Creative Commons Attribution 4.0 License است. نمونه کدها نیز دارای مجوز Apache 2.0 License است. برای اطلاع از جزئیات، به خطمشیهای سایت Google Developers مراجعه کنید. جاوا علامت تجاری ثبتشده Oracle و/یا شرکتهای وابسته به آن است.
تاریخ آخرین بهروزرسانی 2025-03-07 بهوقت ساعت هماهنگ جهانی.
[null,null,["تاریخ آخرین بهروزرسانی 2025-03-07 بهوقت ساعت هماهنگ جهانی."],[[["Suggests budget options for Smart Campaigns, providing low, recommended, and high options with estimated performance metrics."],["Requires a campaign or SuggestionInfo to generate budget suggestions."],["Returns daily budget amounts and estimated daily click ranges for each option."],["Uses the `https://googleads.googleapis.com/v17/customers/{customerId}:suggestSmartCampaignBudgetOptions` endpoint for the request."],["Needs the `https://www.googleapis.com/auth/adwords` OAuth scope for authorization."]]],[]]