احتیاط: شما در حال مشاهده اسناد رابط REST API هستید. اکثر کتابخانه های مشتری رسمی ما از gRPC استفاده می کنند. برای جزئیات بیشتر به مقدمه REST مراجعه کنید.

این صفحه به‌وسیله ‏Cloud Translation API‏ ترجمه شده است.

CampaignBudget

نمایندگی JSON
وضعیت بودجه
روش تحویل بودجه
دوره بودجه
نوع بودجه

بودجه کمپین

نمایندگی JSON

نمایندگی JSON
{ "resourceName": string, "status": enum (`BudgetStatus`), "deliveryMethod": enum (`BudgetDeliveryMethod`), "period": enum (`BudgetPeriod`), "type": enum (`BudgetType`), "alignedBiddingStrategyId": string, "id": string, "name": string, "amountMicros": string, "totalAmountMicros": string, "explicitlyShared": boolean, "referenceCount": string, "hasRecommendedBudget": boolean, "recommendedBudgetAmountMicros": string, "recommendedBudgetEstimatedChangeWeeklyClicks": string, "recommendedBudgetEstimatedChangeWeeklyCostMicros": string, "recommendedBudgetEstimatedChangeWeeklyInteractions": string, "recommendedBudgetEstimatedChangeWeeklyViews": string }

{
  "resourceName": string,
  "status": enum (BudgetStatus),
  "deliveryMethod": enum (BudgetDeliveryMethod),
  "period": enum (BudgetPeriod),
  "type": enum (BudgetType),
  "alignedBiddingStrategyId": string,
  "id": string,
  "name": string,
  "amountMicros": string,
  "totalAmountMicros": string,
  "explicitlyShared": boolean,
  "referenceCount": string,
  "hasRecommendedBudget": boolean,
  "recommendedBudgetAmountMicros": string,
  "recommendedBudgetEstimatedChangeWeeklyClicks": string,
  "recommendedBudgetEstimatedChangeWeeklyCostMicros": string,
  "recommendedBudgetEstimatedChangeWeeklyInteractions": string,
  "recommendedBudgetEstimatedChangeWeeklyViews": string
}

زمینه های
`resourceName`	`string` تغییرناپذیر. نام منبع بودجه کمپین. نام منابع بودجه کمپین به شکل زیر است: `customers/{customerId}/campaignBudgets/{campaign_budget_id}`
`status`	`enum ( BudgetStatus )` فقط خروجی وضعیت بودجه این کمپین. این فیلد فقط خواندنی است.
`deliveryMethod`	`enum ( BudgetDeliveryMethod )` روش تحویلی که میزان هزینه بودجه کمپین را تعیین می کند. اگر در عملیات ایجاد مشخص نشده باشد، به طور پیش‌فرض به استاندارد STANDARD تبدیل می‌شود.
`period`	`enum ( BudgetPeriod )` تغییرناپذیر. دوره ای که باید بودجه را در آن خرج کرد. اگر مشخص نشده باشد به طور پیش فرض روی DAILY قرار می گیرد.
`type`	`enum ( BudgetType )` تغییرناپذیر. نوع بودجه کمپین
`alignedBiddingStrategyId`	`string ( int64 format)` شناسه استراتژی مناقصه نمونه کارها که این بودجه کمپین مشترک با آن هماهنگ است. هنگامی که یک استراتژی مناقصه و یک بودجه کمپین در یک راستا قرار می گیرند، به مجموعه ای از کمپین ها متصل می شوند. پس از اینکه بودجه کمپین با استراتژی مناقصه هماهنگ شد، کمپین هایی که به بودجه کمپین اضافه می شوند باید از استراتژی مناقصه همسو شده نیز استفاده کنند.
`id`	`string ( int64 format)` فقط خروجی شناسه بودجه کمپین. یک بودجه کمپین با استفاده از عملیات ایجاد CampaignBudgetService ایجاد می شود و یک شناسه بودجه به آن اختصاص می یابد. شناسه بودجه را می توان در کمپین های مختلف به اشتراک گذاشت. سپس سیستم بودجه کمپین را بین کمپین های مختلف تخصیص می دهد تا نتایج بهینه را به دست آورد.
`name`	`string` نام بودجه کمپین. هنگام ایجاد بودجه کمپین از طریق CampaignBudgetService، هر بودجه کمپین به طور واضح به اشتراک گذاشته شده باید نامی غیر پوچ و غیر خالی داشته باشد. بودجه کمپین‌هایی که به‌صراحت به اشتراک گذاشته نمی‌شوند، نام خود را از نام کمپین پیوست شده گرفته‌اند. طول این رشته باید بین 1 تا 255، شامل UTF-8 بایت، (بریده شده) باشد.
`amountMicros`	`string ( int64 format)` مقدار بودجه، به ارز محلی برای حساب. مقدار به میکرو مشخص می شود که یک میلیون معادل یک واحد ارز است. هزینه ماهانه 30.4 برابر این مقدار محدود شده است.
`totalAmountMicros`	`string ( int64 format)` مبلغ مادام العمر بودجه، به ارز محلی برای حساب. مقدار به میکرو مشخص می شود که یک میلیون معادل یک واحد ارز است.
`explicitlyShared`	`boolean` مشخص می کند که آیا بودجه به طور صریح مشترک است یا خیر. اگر در عملیات ایجاد مشخص نشده باشد، پیش‌فرض به true می‌شود. اگر درست باشد، بودجه با هدف اشتراک گذاری در یک یا چند کمپین ایجاد شده است. اگر نادرست باشد، بودجه فقط با هدف استفاده از یک کمپین ایجاد شده است. نام و وضعیت بودجه با نام و وضعیت کمپین همگام خواهد بود. تلاش برای تقسیم بودجه با کمپین دوم منجر به خطا می شود. یک بودجه غیر مشترک می تواند به طور واضح به یک بودجه مشترک تبدیل شود. همین عملیات باید به بودجه نیز یک نام اختصاص دهد. بودجه کمپین مشترک هرگز نمی تواند غیر مشترک شود.
`referenceCount`	`string ( int64 format)` فقط خروجی تعداد کمپین هایی که به طور فعال از بودجه استفاده می کنند. این فیلد فقط خواندنی است.
`hasRecommendedBudget`	`boolean` فقط خروجی نشان می دهد که آیا بودجه پیشنهادی برای این بودجه کمپین وجود دارد یا خیر. این فیلد فقط خواندنی است.
`recommendedBudgetAmountMicros`	`string ( int64 format)` فقط خروجی مقدار بودجه توصیه شده اگر پیشنهادی در دسترس نباشد، این مقدار به مقدار بودجه تنظیم می شود. مقدار به میکرو مشخص می شود که یک میلیون معادل یک واحد ارز است. این فیلد فقط خواندنی است.
`recommendedBudgetEstimatedChangeWeeklyClicks`	`string ( int64 format)` فقط خروجی تغییر تخمینی کلیک‌های هفتگی در صورت اعمال بودجه توصیه‌شده. این فیلد فقط خواندنی است.
`recommendedBudgetEstimatedChangeWeeklyCostMicros`	`string ( int64 format)` فقط خروجی تغییر تخمینی هزینه هفتگی بر حسب میکرو در صورت اعمال بودجه توصیه شده. یک میلیون معادل یک واحد ارز است. این فیلد فقط خواندنی است.
`recommendedBudgetEstimatedChangeWeeklyInteractions`	`string ( int64 format)` فقط خروجی تغییر تخمینی در تعاملات هفتگی در صورت اعمال بودجه توصیه شده. این فیلد فقط خواندنی است.
`recommendedBudgetEstimatedChangeWeeklyViews`	`string ( int64 format)` فقط خروجی تغییر تخمینی در بازدیدهای هفتگی در صورت اعمال بودجه توصیه شده. این فیلد فقط خواندنی است.

وضعیت بودجه

وضعیت های احتمالی یک بودجه

Enums
`UNSPECIFIED`	مشخص نشده است.
`UNKNOWN`	فقط برای مقدار برگشتی استفاده می شود. نشان دهنده مقدار ناشناخته در این نسخه است.
`ENABLED`	بودجه فعال است.
`REMOVED`	بودجه حذف می شود.

روش تحویل بودجه

روش های ممکن تحویل بودجه

Enums
`UNSPECIFIED`	مشخص نشده است.
`UNKNOWN`	فقط برای مقدار برگشتی استفاده می شود. نشان دهنده مقدار ناشناخته در این نسخه است.
`STANDARD`	سرور بودجه در کل دوره زمانی سرویس دهی را به طور مساوی انجام می دهد.
`ACCELERATED`	سرور بودجه سرویس دهی را کاهش نمی دهد و تبلیغات در سریع ترین زمان ممکن ارائه می شود.

دوره بودجه

دوره احتمالی بودجه

Enums
`UNSPECIFIED`	مشخص نشده است.
`UNKNOWN`	فقط برای مقدار برگشتی استفاده می شود. نشان دهنده مقدار ناشناخته در این نسخه است.
`DAILY`	بودجه روزانه.
`CUSTOM_PERIOD`	بودجه سفارشی، در نسخه 5 اضافه شده است. بودجه سفارشی را می توان با total_amount برای تعیین محدودیت بودجه مادام العمر استفاده کرد. برای اطلاعات بیشتر به https://support.google.com/google-ads/answer/6385083 مراجعه کنید.

نوع بودجه

انواع بودجه ممکن

Enums
`UNSPECIFIED`	مشخص نشده است.
`UNKNOWN`	فقط برای مقدار برگشتی استفاده می شود. نشان دهنده مقدار ناشناخته در این نسخه است.
`STANDARD`	نوع بودجه برای استفاده استاندارد از Google Ads. سقف هزینه روزانه را دو برابر مقدار بودجه مشخص شده می کند. جزئیات کامل: https://support.google.com/google-ads/answer/6385083
`FIXED_CPA`	نوع بودجه با هزینه ثابت به ازای هر خرید (تبدیل). جزئیات کامل: https://support.google.com/google-ads/answer/7528254 این نوع فقط توسط کمپین هایی با AdvertisingChannelType.DISPLAY (به استثنای AdvertisingChannelSubType.DISPLAY_GMAIL)، BiddingStrategyType.TARGET_CPA و PaymentMode.CONVERSIONS پشتیبانی می شود.
`SMART_CAMPAIGN`	نوع بودجه برای کمپین هوشمند. جزئیات کامل: https://support.google.com/google-ads/answer/7653509 این نوع فقط توسط کمپین هایی با AdvertisingChannelType.SMART و AdvertisingChannelSubType.SMART_CAMPAIGN پشتیبانی می شود.
`LOCAL_SERVICES`	نوع بودجه برای کمپین خدمات محلی. جزئیات کامل: https://support.google.com/localservices/answer/7434558 این نوع فقط توسط کمپین هایی با AdvertisingChannelType.LOCAL_SERVICES پشتیبانی می شود.