Chú ý: Bạn đang xem tài liệu về giao diện REST của API. Hầu hết các thư viện ứng dụng chính thức của chúng tôi đều sử dụng gRPC. Hãy xem Giới thiệu về REST để biết chi tiết.

Trang này được dịch bởi Cloud Translation API.

CampaignBudget

Biểu diễn dưới dạng JSON
BudgetStatus
BudgetDeliveryMethod
BudgetPeriod
BudgetType

Ngân sách chiến dịch.

Biểu diễn dưới dạng JSON

Biểu diễn dưới dạng 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
}

Các trường
`resourceName`	`string` Không thể thay đổi. Tên tài nguyên của ngân sách chiến dịch. Tên tài nguyên ngân sách chiến dịch có dạng: `customers/{customerId}/campaignBudgets/{campaign_budget_id}`
`status`	`enum (BudgetStatus)` Chỉ có đầu ra. Trạng thái của ngân sách chiến dịch này. Trường này chỉ để đọc.
`deliveryMethod`	`enum (BudgetDeliveryMethod)` Cách phân phối xác định tỷ lệ chi tiêu ngân sách chiến dịch. Giá trị mặc định là STANDARD nếu không được chỉ định trong thao tác tạo.
`period`	`enum (BudgetPeriod)` Không thể thay đổi. Khoảng thời gian để chi tiêu ngân sách. Giá trị mặc định là "HÀNG NGÀY" nếu không được chỉ định.
`type`	`enum (BudgetType)` Không thể thay đổi. Loại ngân sách chiến dịch.
`alignedBiddingStrategyId`	`string (int64 format)` Mã của chiến lược giá thầu danh mục đầu tư phù hợp với ngân sách chiến dịch dùng chung này. Khi chiến lược đặt giá thầu và ngân sách chiến dịch phù hợp, chúng sẽ được gắn vào cùng một nhóm chiến dịch. Sau khi điều chỉnh ngân sách chiến dịch cho phù hợp với chiến lược đặt giá thầu, những chiến dịch được thêm vào ngân sách chiến dịch cũng phải sử dụng chiến lược đặt giá thầu tương ứng.
`id`	`string (int64 format)` Chỉ có đầu ra. Mã ngân sách chiến dịch. Ngân sách chiến dịch được tạo bằng cách sử dụng thao tác tạo CampaignBudgetService và được chỉ định một mã ngân sách. Bạn có thể dùng chung một mã ngân sách cho nhiều chiến dịch; sau đó, hệ thống sẽ phân bổ ngân sách chiến dịch cho các chiến dịch khác nhau để đạt được kết quả tối ưu.
`name`	`string` Tên ngân sách chiến dịch. Khi tạo ngân sách chiến dịch thông qua CampaignNgân sáchService, mọi ngân sách chiến dịch được chia sẻ rõ ràng phải có tên phải có giá trị rỗng, không để trống. Ngân sách chiến dịch không được chia sẻ rõ ràng được lấy từ tên của chiến dịch đính kèm. Độ dài của chuỗi này phải nằm trong khoảng từ 1 đến 255, tính bằng byte UTF-8 (đã cắt).
`amountMicros`	`string (int64 format)` Số tiền ngân sách, theo nội tệ cho tài khoản. Số tiền được chỉ định bằng micro, trong đó một triệu tương đương với một đơn vị tiền tệ. Mức chi tiêu hằng tháng được giới hạn ở mức gấp 30,4 lần số tiền này.
`totalAmountMicros`	`string (int64 format)` Số tiền ngân sách trong suốt thời gian hoạt động, tính bằng nội tệ của tài khoản. Số tiền được chỉ định bằng micro, trong đó một triệu tương đương với một đơn vị tiền tệ.
`explicitlyShared`	`boolean` Chỉ định xem ngân sách có được chia sẻ rõ ràng hay không. Giá trị mặc định là true nếu không được chỉ định trong tác vụ tạo. Nếu đúng, thì ngân sách đã được tạo với mục đích chia sẻ trên một hoặc nhiều chiến dịch. Nếu giá trị là sai thì ngân sách đã được tạo với mục đích chỉ dùng cho một chiến dịch. Tên và trạng thái của ngân sách sẽ luôn đồng bộ với tên và trạng thái của chiến dịch. Nếu cố gắng chia sẻ ngân sách với chiến dịch thứ hai, thì sẽ xảy ra lỗi. Ngân sách không được chia sẻ có thể trở thành ngân sách được chia sẻ rõ ràng. Thao tác tương tự cũng phải chỉ định tên cho ngân sách. Ngân sách chiến dịch được chia sẻ không bao giờ trở thành ngân sách không được chia sẻ.
`referenceCount`	`string (int64 format)` Chỉ có đầu ra. Số chiến dịch đang sử dụng ngân sách. Trường này chỉ để đọc.
`hasRecommendedBudget`	`boolean` Chỉ có đầu ra. Cho biết có ngân sách đề xuất cho ngân sách chiến dịch này hay không. Trường này chỉ để đọc.
`recommendedBudgetAmountMicros`	`string (int64 format)` Chỉ có đầu ra. Số tiền ngân sách đề xuất. Nếu không có đề xuất nào, giá trị này sẽ được đặt thành số tiền ngân sách. Số tiền được chỉ định bằng micro, trong đó một triệu tương đương với một đơn vị tiền tệ. Trường này chỉ để đọc.
`recommendedBudgetEstimatedChangeWeeklyClicks`	`string (int64 format)` Chỉ có đầu ra. Sự thay đổi ước tính về số lượt nhấp hằng tuần nếu áp dụng ngân sách đề xuất. Trường này chỉ để đọc.
`recommendedBudgetEstimatedChangeWeeklyCostMicros`	`string (int64 format)` Chỉ có đầu ra. Mức thay đổi ước tính về chi phí hằng tuần cực nhỏ nếu áp dụng ngân sách đề xuất. Một triệu tương đương với một đơn vị tiền tệ. Trường này chỉ để đọc.
`recommendedBudgetEstimatedChangeWeeklyInteractions`	`string (int64 format)` Chỉ có đầu ra. Mức thay đổi ước tính về số lượt tương tác hằng tuần nếu áp dụng ngân sách đề xuất. Trường này chỉ để đọc.
`recommendedBudgetEstimatedChangeWeeklyViews`	`string (int64 format)` Chỉ có đầu ra. Mức thay đổi ước tính về số lượt xem hằng tuần nếu áp dụng ngân sách đề xuất. Trường này chỉ để đọc.

BudgetStatus

Các trạng thái có thể có của Ngân sách.

Enum
`UNSPECIFIED`	Chưa xác định.
`UNKNOWN`	Chỉ dùng cho giá trị trả về. Đại diện cho giá trị không xác định trong phiên bản này.
`ENABLED`	Ngân sách đã được bật.
`REMOVED`	Ngân sách đã bị xóa.

BudgetDeliveryMethod

Các phương pháp phân phối có thể có của Ngân sách.

Enum
`UNSPECIFIED`	Chưa xác định.
`UNKNOWN`	Chỉ dùng cho giá trị trả về. Đại diện cho giá trị không xác định trong phiên bản này.
`STANDARD`	Máy chủ ngân sách sẽ điều tiết việc phân phát đồng đều trong toàn bộ khoảng thời gian.
`ACCELERATED`	Máy chủ ngân sách sẽ không chặn việc phân phát và quảng cáo sẽ phân phát nhanh nhất có thể.

BudgetPeriod

Khoảng thời gian có thể có của Ngân sách.

Enum
`UNSPECIFIED`	Chưa xác định.
`UNKNOWN`	Chỉ dùng cho giá trị trả về. Đại diện cho giá trị không xác định trong phiên bản này.
`DAILY`	Ngân sách hàng ngày.
`CUSTOM_PERIOD`	Ngân sách tuỳ chỉnh, đã được thêm lại trong phiên bản 5. Bạn có thể sử dụng ngân sách tuỳ chỉnh cùng với total_amount để chỉ định giới hạn ngân sách toàn thời gian. Hãy tham khảo bài viết: https://support.google.com/google-ads/answer/6385083 để biết thêm thông tin.

BudgetType

Các loại Ngân sách có thể có.

Enum
`UNSPECIFIED`	Chưa xác định.
`UNKNOWN`	Chỉ dùng cho giá trị trả về. Đại diện cho giá trị không xác định trong phiên bản này.
`STANDARD`	Loại ngân sách cho mức sử dụng Google Ads tiêu chuẩn. Giới hạn mức chi tiêu hằng ngày gấp hai lần số tiền ngân sách đã chỉ định. Toàn bộ chi tiết: https://support.google.com/google-ads/answer/6385083
`FIXED_CPA`	Loại ngân sách có chi phí thu nạp khách hàng (lượt chuyển đổi) cố định. Toàn bộ thông tin chi tiết: https://support.google.com/google-ads/answer/7528254 Loại này chỉ được hỗ trợ bởi những chiến dịch có AdvertisingChannelType.DISPLAY (không bao gồm AdvertisingChannelSubType.DISPLAY_XXX), BiddingStrategyType.TARGET_CPA và PaymentMode. %.
`SMART_CAMPAIGN`	Loại ngân sách cho Chiến dịch thông minh. Toàn bộ chi tiết: https://support.google.com/google-ads/answer/7653509 Loại này chỉ được hỗ trợ bởi các chiến dịch có AdvertisingChannelType.SMART và AdvertisingChannelSubType.SMART_CAMPAIGN.
`LOCAL_SERVICES`	Loại ngân sách cho chiến dịch Dịch vụ địa phương. Toàn bộ chi tiết: https://support.google.com/localservices/answer/7434558 Loại này chỉ được hỗ trợ bởi các chiến dịch có AdvertisingChannelType.LOCAL_SERVICES.