주의: 이 API의 REST 인터페이스에 대한 문서를 보고 있습니다. 대부분의 공식 클라이언트 라이브러리는 gRPC를 사용합니다. 자세한 내용은 REST 소개를 참조하세요.

이 페이지는 Cloud Translation API를 통해 번역되었습니다.

CampaignBudget

JSON 표현
BudgetStatus
BudgetDeliveryMethod
BudgetPeriod
BudgetType

캠페인 예산입니다.

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입니다. 입찰 전략과 캠페인 예산이 일치하면 동일한 캠페인 집합에 연결됩니다. 캠페인 예산이 입찰 전략에 맞게 조정되면 캠페인 예산에 추가되는 캠페인도 조정된 입찰 전략을 사용해야 합니다.
`id`	`string (int64 format)` 출력 전용. 캠페인 예산의 ID입니다. 캠페인 예산은 CampaignBudgetService 만들기 작업을 통해 생성되며 예산 ID가 할당됩니다. 예산 ID는 여러 캠페인에서 공유할 수 있습니다. 그러면 시스템이 최적의 결과를 얻기 위해 여러 캠페인에 캠페인 예산을 할당합니다.
`name`	`string` 캠페인 예산의 이름입니다. CampaignBudgetService를 통해 캠페인 예산을 만들 때는 모든 명시적 공유 캠페인 예산에는 null이 아니고, 비어 있지 않은 이름이 있어야 합니다. 명시적으로 공유되지 않은 캠페인 예산은 연결된 캠페인의 이름에서 생성됩니다. 이 문자열의 길이는 1에서 255 사이여야 하며 UTF-8 바이트로 표현되어야 합니다(잘림).
`amountMicros`	`string (int64 format)` 예산 금액(계정의 현지 통화)입니다. 금액은 마이크로 단위로 지정되며, 100만은 통화 단위 1에 해당합니다. 월별 지출은 이 금액의 30.4배로 제한됩니다.
`totalAmountMicros`	`string (int64 format)` 계정에 대해 현지 통화로 표시되는 전체 기간 예산 금액입니다. 금액은 마이크로 단위로 지정되며, 100만은 통화 단위 1에 해당합니다.
`explicitlyShared`	`boolean` 예산을 명시적으로 공유할지 여부를 지정합니다. 만들기 작업에서 지정되지 않으면 기본값은 true입니다. true인 경우 하나 이상의 캠페인에서 공유할 목적으로 예산이 생성된 것입니다. false이면 단일 캠페인에서만 사용할 목적으로 예산이 생성된 것입니다. 예산의 이름과 상태는 캠페인 이름 및 상태와 계속 동기화됩니다. 다른 캠페인과 예산을 공유하려고 하면 오류가 발생합니다. 비공유 예산은 명시적으로 공유될 수 있습니다. 동일한 작업에서 예산에 이름을 지정해야 합니다. 공유 캠페인 예산은 공유되지 않습니다.
`referenceCount`	`string (int64 format)` 출력 전용. 예산을 적극적으로 사용하고 있는 캠페인의 수입니다. 이 필드는 읽기 전용입니다.
`hasRecommendedBudget`	`boolean` 출력 전용. 이 캠페인 예산에 권장 예산이 있는지 여부를 나타냅니다. 이 필드는 읽기 전용입니다.
`recommendedBudgetAmountMicros`	`string (int64 format)` 출력 전용. 권장 예산 금액입니다. 추천이 없으면 예산 금액으로 설정됩니다. 금액은 마이크로 단위로 지정되며, 100만은 통화 단위 1에 해당합니다. 이 필드는 읽기 전용입니다.
`recommendedBudgetEstimatedChangeWeeklyClicks`	`string (int64 format)` 출력 전용. 권장 예산을 적용할 경우 예상되는 주간 클릭수 변화입니다. 이 필드는 읽기 전용입니다.
`recommendedBudgetEstimatedChangeWeeklyCostMicros`	`string (int64 format)` 출력 전용. 권장 예산을 적용할 경우 예상되는 주간 비용 변화(마이크로 단위)입니다. 100만은 하나의 통화 단위에 해당합니다. 이 필드는 읽기 전용입니다.
`recommendedBudgetEstimatedChangeWeeklyInteractions`	`string (int64 format)` 출력 전용. 추천 예산을 적용할 경우 예상되는 주간 상호작용 변화입니다. 이 필드는 읽기 전용입니다.
`recommendedBudgetEstimatedChangeWeeklyViews`	`string (int64 format)` 출력 전용. 추천 예산을 적용할 경우 예상되는 주간 조회수 변화입니다. 이 필드는 읽기 전용입니다.

BudgetStatus

예산의 가능한 상태입니다.

열거형
`UNSPECIFIED`	지정되지 않음
`UNKNOWN`	반환 값에만 사용됩니다. 이 버전에서 알 수 없는 값을 나타냅니다.
`ENABLED`	예산이 사용 설정되었습니다.
`REMOVED`	예산이 삭제되었습니다.

BudgetDeliveryMethod

가능한 예산 집행 방법입니다.

열거형
`UNSPECIFIED`	지정되지 않음
`UNKNOWN`	반환 값에만 사용됩니다. 이 버전에서 알 수 없는 값을 나타냅니다.
`STANDARD`	예산 서버가 전체 기간에 걸쳐 게재를 균등하게 조정합니다.
`ACCELERATED`	예산 서버에서 게재를 제한하지 않으며 광고가 최대한 빠르게 게재됩니다.

BudgetPeriod

가능한 예산 기간입니다.

열거형
`UNSPECIFIED`	지정되지 않음
`UNKNOWN`	반환 값에만 사용됩니다. 이 버전에서 알 수 없는 값을 나타냅니다.
`DAILY`	일일예산:
`CUSTOM_PERIOD`	맞춤 예산이 V5에서 다시 추가되었습니다. 맞춤 예산을 total_amount와 함께 사용하여 전체 기간 예산 한도를 지정할 수 있습니다. 자세한 내용은 https://support.google.com/google-ads/answer/6385083을 참고하세요.

BudgetType

가능한 예산 유형입니다.

열거형
`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가 있는 캠페인에서만 지원됩니다.