Method: customers.recommendations.apply

해당 apply 매개변수와 함께 특정 추천을 적용합니다.

발생한 오류 목록: AuthenticationError AuthorizationError DatabaseError FieldError HeaderError InternalError MutateError QuotaError RecommendationError RequestError UrlFieldError

HTTP 요청

POST https://googleads.googleapis.com/v14/customers/{customerId}/recommendations:apply

URL은 gRPC 트랜스코딩 구문을 사용합니다.

경로 매개변수

매개변수
customerId

string

필수 항목입니다. 추천이 있는 고객의 ID입니다.

요청 본문

요청 본문에는 다음과 같은 구조의 데이터가 포함됩니다.

JSON 표현 
{
  "operations": [
    {
      object (ApplyRecommendationOperation)
    }
  ],
  "partialFailure": boolean
}
필드
operations[]

object (ApplyRecommendationOperation)

필수 항목입니다. 추천을 적용할 작업의 목록입니다. InvalidFailure=false인 경우 모든 권장사항은 동일한 유형이어야 합니다. 요청당 작업은 100개로 제한됩니다.
partialFailure

boolean

true인 경우 성공한 작업이 수행되고 잘못된 작업은 오류를 반환합니다. false인 경우 작업이 모두 유효한 경우에만 트랜잭션으로 실행됩니다. 기본값은 false입니다.

응답 본문

RecommendationService.ApplyRecommendation의 응답 메시지입니다.

성공할 경우 응답 본문에 다음 구조의 데이터가 포함됩니다.

JSON 표현 
{
  "results": [
    {
      object (ApplyRecommendationResult)
    }
  ],
  "partialFailureError": {
    object (Status)
  }
}
필드
results[]

object (ApplyRecommendationResult)

추천을 적용하기 위한 작업 결과입니다.
partialFailureError

object (Status)

부분 실패 모드의 작업 실패와 관련된 오류입니다. InvalidFailure = true이고 작업 내에서 모든 오류가 발생하는 경우에만 반환됩니다. 작업 외부에서 오류 (예: 인증 오류)가 발생하면 RPC 수준 오류가 반환됩니다.

승인 범위

다음 OAuth 범위가 필요합니다.

  • https://www.googleapis.com/auth/adwords

자세한 내용은 OAuth 2.0 개요를 참고하세요.

ApplyRecommendationOperation

추천을 적용하는 작업과 이를 맞춤설정하는 매개변수에 대한 정보입니다.

JSON 표현 
{
  "resourceName": string,

  // Union field apply_parameters can be only one of the following:
  "campaignBudget": {
    object (CampaignBudgetParameters)
  },
  "textAd": {
    object (TextAdParameters)
  },
  "keyword": {
    object (KeywordParameters)
  },
  "targetCpaOptIn": {
    object (TargetCpaOptInParameters)
  },
  "targetRoasOptIn": {
    object (TargetRoasOptInParameters)
  },
  "calloutExtension": {
    object (CalloutExtensionParameters)
  },
  "callExtension": {
    object (CallExtensionParameters)
  },
  "sitelinkExtension": {
    object (SitelinkExtensionParameters)
  },
  "moveUnusedBudget": {
    object (MoveUnusedBudgetParameters)
  },
  "responsiveSearchAd": {
    object (ResponsiveSearchAdParameters)
  },
  "useBroadMatchKeyword": {
    object (UseBroadMatchKeywordParameters)
  },
  "responsiveSearchAdAsset": {
    object (ResponsiveSearchAdAssetParameters)
  },
  "responsiveSearchAdImproveAdStrength": {
    object (ResponsiveSearchAdImproveAdStrengthParameters)
  },
  "raiseTargetCpaBidTooLow": {
    object (RaiseTargetCpaBidTooLowParameters)
  },
  "forecastingSetTargetRoas": {
    object (ForecastingSetTargetRoasParameters)
  },
  "calloutAsset": {
    object (CalloutAssetParameters)
  },
  "callAsset": {
    object (CallAssetParameters)
  },
  "sitelinkAsset": {
    object (SitelinkAssetParameters)
  },
  "raiseTargetCpa": {
    object (RaiseTargetCpaParameters)
  },
  "lowerTargetRoas": {
    object (LowerTargetRoasParameters)
  }
  // End of list of possible types for union field apply_parameters.
}
필드
resourceName

string

적용할 추천의 리소스 이름입니다.
통합 필드 apply_parameters. 추천을 적용할 때 사용할 매개변수입니다. apply_parameters은 다음 중 하나여야 합니다.
campaignBudget

object (CampaignBudgetParameters)

캠페인 예산 추천을 적용할 때 사용할 선택적 매개변수입니다.
textAd

object (TextAdParameters)

텍스트 광고 추천을 적용할 때 사용할 선택적 매개변수입니다.
keyword

object (KeywordParameters)

키워드 추천을 적용할 때 사용할 선택적 매개변수입니다.
targetCpaOptIn

object (TargetCpaOptInParameters)

타겟 CPA 선택 추천을 적용할 때 사용할 선택적 매개변수입니다.
targetRoasOptIn

object (TargetRoasOptInParameters)

타겟 ROAS 선택 추천을 적용할 때 사용할 선택적 매개변수입니다.
calloutExtension

object (CalloutExtensionParameters)

콜아웃 광고 확장 추천을 적용할 때 사용할 매개변수입니다.
callExtension

object (CallExtensionParameters)

전화번호 광고 확장 추천을 적용할 때 사용할 매개변수입니다.
moveUnusedBudget

object (MoveUnusedBudgetParameters)

사용하지 않는 예산 추천을 적용할 때 사용할 매개변수입니다.
responsiveSearchAd

object (ResponsiveSearchAdParameters)

반응형 검색 광고 추천을 적용할 때 사용할 매개변수입니다.
useBroadMatchKeyword

object (UseBroadMatchKeywordParameters)

확장검색 키워드 사용 추천을 적용할 때 사용할 매개변수입니다.
responsiveSearchAdAsset

object (ResponsiveSearchAdAssetParameters)

반응형 검색 광고 확장 소재 추천을 적용할 때 사용할 매개변수입니다.
responsiveSearchAdImproveAdStrength

object (ResponsiveSearchAdImproveAdStrengthParameters)

반응형 검색 광고를 적용할 때 광고 효력 추천을 개선할 때 사용하는 매개변수입니다.
raiseTargetCpaBidTooLow

object (RaiseTargetCpaBidTooLowParameters)

인상된 타겟 CPA 입찰가를 너무 낮은 추천을 적용할 때 사용하는 매개변수입니다. 이 과정은 비동기식이며 관련 캠페인에 있는 광고그룹 수에 따라 몇 분 정도 걸릴 수 있습니다.
forecastingSetTargetRoas

object (ForecastingSetTargetRoasParameters)

설정된 타겟 광고 투자수익(ROAS) 추천을 예측에 적용할 때 사용할 매개변수입니다.
calloutAsset

object (CalloutAssetParameters)

콜아웃 확장 소재 추천을 적용할 때 사용할 매개변수입니다.
callAsset

object (CallAssetParameters)

전화번호 확장 소재 추천을 적용할 때 사용할 매개변수입니다.
raiseTargetCpa

object (RaiseTargetCpaParameters)

적용 시 사용할 매개변수는 타겟 CPA 추천을 높입니다.
lowerTargetRoas

object (LowerTargetRoasParameters)

더 낮은 타겟 ROAS 추천을 적용할 때 사용할 매개변수입니다.

CampaignBudgetParameters

캠페인 예산 추천을 적용할 때 사용할 매개변수입니다.

JSON 표현 
{
  "newBudgetAmountMicros": string
}
필드
newBudgetAmountMicros

string (int64 format)

타겟 예산 리소스에 설정할 새 예산 금액입니다. 필수 필드입니다.

TextAdParameters

텍스트 광고 추천을 적용할 때 사용할 매개변수입니다.

JSON 표현 
{
  "ad": {
    object (Ad)
  }
}
필드
ad

object (Ad)

추천 광고그룹에 추가할 새 광고입니다. 필수 입력란을 모두 이 메시지에 설정해야 합니다. 필수 필드입니다.

KeywordParameters

키워드 추천을 적용할 때 사용할 매개변수입니다.

JSON 표현 
{
  "matchType": enum (KeywordMatchType),
  "adGroup": string,
  "cpcBidMicros": string
}
필드
matchType

enum (KeywordMatchType)

키워드의 일치 유형입니다. 필수 필드입니다.
adGroup

string

키워드를 추가할 광고그룹 리소스입니다. 필수 필드입니다.
cpcBidMicros

string (int64 format)

키워드에 설정할 CPC 입찰가입니다(선택사항). 설정하지 않으면 키워드는 타겟 광고그룹에서 사용한 입찰 전략에 따른 입찰가를 사용합니다.

TargetCpaOptInParameters

타겟 CPA 추천을 적용할 때 사용할 매개변수입니다.

JSON 표현 
{
  "targetCpaMicros": string,
  "newCampaignBudgetAmountMicros": string
}
필드
targetCpaMicros

string (int64 format)

타겟 CPA 입찰 전략에 사용할 평균 CPA입니다. 필수 필드입니다.
newCampaignBudgetAmountMicros

string (int64 format)

캠페인에 설정할 예산 금액입니다(선택사항).

TargetRoasOptInParameters

타겟 ROAS 선택 추천을 적용할 때 사용할 매개변수입니다.

JSON 표현 
{
  "targetRoas": number,
  "newCampaignBudgetAmountMicros": string
}
필드
targetRoas

number

타겟 광고 투자수익(ROAS) 입찰 전략에 사용할 평균 ROAS(지출 단위당 수익)입니다. 값은 0.01 이상 1000.0 이하여야 합니다. newCampaignBudgetAmountMicros가 설정되지 않은 한 필수 입력란입니다.
newCampaignBudgetAmountMicros

string (int64 format)

캠페인에 설정할 예산 금액입니다(선택사항).

CalloutExtensionParameters

콜아웃 광고 확장 추천을 적용할 때 사용할 매개변수입니다.

JSON 표현 
{
  "calloutExtensions": [
    {
      object (CalloutFeedItem)
    }
  ]
}
필드
calloutExtensions[]

object (CalloutFeedItem)

콜아웃 광고 확장이 추가될 예정입니다. 필수 필드입니다.

CallExtensionParameters

전화번호 광고 확장 추천을 적용할 때 사용할 매개변수입니다.

JSON 표현 
{
  "callExtensions": [
    {
      object (CallFeedItem)
    }
  ]
}
필드
callExtensions[]

object (CallFeedItem)

추가할 전화번호 광고 확장입니다. 필수 필드입니다.

SitelinkExtensionParameters

사이트링크 추천을 적용할 때 사용할 매개변수입니다.

JSON 표현 
{
  "sitelinkExtensions": [
    {
      object (SitelinkFeedItem)
    }
  ]
}
필드

MoveUnusedBudgetParameters

사용하지 않는 예산 추천을 적용할 때 사용할 매개변수입니다.

JSON 표현 
{
  "budgetMicrosToMove": string
}
필드
budgetMicrosToMove

string (int64 format)

초과 예산에서 제한된 예산으로 이동할 예산 금액입니다. 필수 필드입니다.

ResponsiveSearchAdParameters

반응형 검색 광고 추천을 적용할 때 사용할 매개변수입니다.

JSON 표현 
{
  "ad": {
    object (Ad)
  }
}
필드
ad

object (Ad)

필수 항목입니다. 추천 광고그룹에 추가할 새 광고입니다.

UseBroadMatchKeywordParameters

확장검색 키워드 사용 추천을 적용할 때 사용할 매개변수입니다.

JSON 표현 
{
  "newBudgetAmountMicros": string
}
필드
newBudgetAmountMicros

string (int64 format)

타겟 예산 리소스에 설정할 새 예산 금액입니다.

ResponsiveSearchAdAssetParameters

반응형 검색 광고 확장 소재 추천을 적용할 때 사용할 매개변수입니다.

JSON 표현 
{
  "updatedAd": {
    object (Ad)
  }
}
필드
updatedAd

object (Ad)

광고가 업데이트되었습니다. 기존 광고의 콘텐츠가 대체됩니다.

ResponsiveSearchAdImproveAdStrengthParameters

반응형 검색 광고를 적용할 때 광고 효력 추천을 개선할 때 사용하는 매개변수입니다.

JSON 표현 
{
  "updatedAd": {
    object (Ad)
  }
}
필드
updatedAd

object (Ad)

광고가 업데이트되었습니다. 기존 광고의 콘텐츠가 대체됩니다.

RaiseTargetCpaBidTooLowParameters

인상된 타겟 CPA 입찰가를 너무 낮은 추천을 적용할 때 사용하는 매개변수입니다. 이 작업은 비동기식이며 관련 캠페인에 있는 광고그룹 수에 따라 몇 분 정도 걸릴 수 있습니다.

JSON 표현 
{
  "targetMultiplier": number
}
필드
targetMultiplier

number

필수 항목입니다. 1.0보다 큰 숫자이며, 타겟 CPA를 증가시키는 배율을 나타냅니다. 필수 필드입니다.

ForecastingSetTargetRoasParameters

예측 설정된 타겟 광고 투자수익(ROAS) 추천을 적용할 때 사용할 매개변수입니다.

JSON 표현 
{
  "targetRoas": number,
  "campaignBudgetAmountMicros": string
}
필드
targetRoas

number

캠페인 리소스에 설정할 새 타겟 ROAS (지출 단위당 수익) 값은 0.01 이상 1000.0 이하여야 합니다.
campaignBudgetAmountMicros

string (int64 format)

캠페인 리소스에 설정할 새 캠페인 예산 금액입니다.

CalloutAssetParameters

콜아웃 확장 소재 추천을 적용할 때 사용할 매개변수입니다.

JSON 표현 
{
  "adAssetApplyParameters": {
    object (AdAssetApplyParameters)
  }
}
필드
adAssetApplyParameters

object (AdAssetApplyParameters)

필수 항목입니다. 추가할 콜아웃 확장 소재입니다. 필수 필드입니다.

AdAssetApplyParameters

광고 확장 소재 추천을 적용할 때 사용되는 일반적인 매개변수입니다.

JSON 표현 
{
  "newAssets": [
    {
      object (Asset)
    }
  ],
  "existingAssets": [
    string
  ],
  "scope": enum (ApplyScope)
}
필드
newAssets[]

object (Asset)

만들어 범위에 연결할 애셋입니다. 동일한 호출에서 기존 확장 소재와 결합할 수 있습니다.
existingAssets[]

string

범위에 연결할 기존 애셋의 리소스 이름입니다. 동일한 호출에서 newAssets와 결합할 수도 있습니다.
scope

enum (ApplyScope)

필수 항목입니다. 애셋을 적용할 범위입니다. 캠페인 범위 수준의 확장 소재는 추천과 연결된 캠페인에 적용됩니다. 고객 범위에 해당하는 애셋은 계정 전체에 적용됩니다. 캠페인 범위의 애셋이 고객 범위에 연결된 애셋보다 우선 적용됩니다.

ApplyScope

애셋을 적용할 범위입니다.

열거형
UNSPECIFIED 적용 범위가 지정되지 않았습니다.
UNKNOWN 알 수 없는 작업입니다.
CUSTOMER 고객 범위에서 적용합니다.
CAMPAIGN 캠페인 범위에서 적용합니다.

CallAssetParameters

전화번호 확장 소재 추천을 적용할 때 사용할 매개변수입니다.

JSON 표현 
{
  "adAssetApplyParameters": {
    object (AdAssetApplyParameters)
  }
}
필드
adAssetApplyParameters

object (AdAssetApplyParameters)

필수 항목입니다. 추가할 전화번호 확장 소재입니다. 필수 필드입니다.

SitelinkAssetParameters

사이트링크 확장 소재 추천을 적용할 때 사용할 매개변수입니다.

JSON 표현 
{
  "adAssetApplyParameters": {
    object (AdAssetApplyParameters)
  }
}
필드
adAssetApplyParameters

object (AdAssetApplyParameters)

필수 항목입니다. 추가할 사이트링크 확장 소재입니다. 필수 필드입니다.

RaiseTargetCpaParameters

적용 시 사용할 매개변수는 타겟 CPA 추천을 높입니다.

JSON 표현 
{
  "targetCpaMultiplier": number
}
필드
targetCpaMultiplier

number

필수 항목입니다. CPA 배율을 설정할 타겟입니다. 필수 필드입니다.

LowerTargetRoasParameters

더 낮은 타겟 ROAS 추천을 적용할 때 사용할 매개변수입니다.

JSON 표현 
{
  "targetRoasMultiplier": number
}
필드
targetRoasMultiplier

number

필수 항목입니다. ROAS 배율을 설정할 타겟입니다. 필수 필드입니다.

ApplyRecommendationResult

추천을 적용한 결과입니다.

JSON 표현 
{
  "resourceName": string
}
필드
resourceName

string

적용에 성공하면 반환됩니다.