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
}

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 bạn không chỉ định trong tác vụ 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à 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ư sẽ 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 được điều chỉnh cho phù hợp, thì chúng sẽ được áp dụng cho cùng một nhóm chiến dịch. Sau khi ngân sách chiến dịch phù hợp với một 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 phù hợp.
`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 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ã 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 để 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 CampaignBudgetService, mọi ngân sách chiến dịch được chia sẻ rõ ràng phải có tên không rỗng và không được để 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 bỏ).
`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 micrô, 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 toàn thời gian của ngân sách, bằng nội tệ cho tài khoản. Số tiền được chỉ định bằng micrô, 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à đúng nếu bạn chưa chỉ định trong tác vụ tạo. Nếu đúng, ngân sách đã được tạo để chia sẻ trên một hoặc nhiều chiến dịch. Nếu đặt là false, thì ngân sách đã được tạo với ý định 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. Việc cố gắng chia sẻ ngân sách với chiến dịch thứ hai sẽ dẫn đến lỗi. Ngân sách không dùng chung 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ờ có thể trở thành không chia sẻ.
`referenceCount`	`string (int64 format)` Chỉ có đầu ra. Số lượng 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, thì giá trị này sẽ được đặt thành số tiền ngân sách. Số tiền được chỉ định bằng micrô, 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. Mức 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 tính theo phần triệu 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 chỉ đị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 Ngân sách có thể có.

Enum
`UNSPECIFIED`	Chưa chỉ đị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 hoạt động 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 hạn chế 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 chỉ đị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 tùy 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 truy cập vào: https://support.google.com/google-ads/answer/6385083 để biết thêm thông tin.

BudgetType

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

Enum
`UNSPECIFIED`	Chưa chỉ đị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 để 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. Thông tin đầy đủ: 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 chiến dịch này chỉ được hỗ trợ bởi những chiến dịch có AdvertisingChannelType.DISPLAY (không bao gồm AdvertisingChannelSubType.DISPLAY_ nhằm)
`SMART_CAMPAIGN`	Loại ngân sách cho Chiến dịch thông minh. Thông tin đầy đủ: https://support.google.com/google-ads/answer/7653509 Loại này chỉ được hỗ trợ trong 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ộ thông tin chi tiết: https://support.google.com/localservices/answer/7434558 Loại này chỉ được hỗ trợ trong các chiến dịch có AdvertisingChannelType.LOCAL_SERVICES.