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

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

Customer

JSON 표현
CallReportingSetting
- JSON 표현
ConversionTrackingSetting
- JSON 표현
ConversionTrackingStatus
RemarketingSetting
- JSON 표현
CustomerPayPerConversionEligibilityFailureReason
OfflineConversionClientSummary
- JSON 표현
OfflineEventUploadClient
OfflineConversionDiagnosticStatus
OfflineConversionUploadSummary
- JSON 표현
OfflineConversionUploadAlert
- JSON 표현
OfflineConversionUploadError
- JSON 표현
CollectionSizeError
ConversionAdjustmentUploadError
ConversionUploadError
DateError
DistinctError
FieldError
MutateError
NotAllowlistedError
StringFormatError
StringLengthError
CustomerAgreementSetting
- JSON 표현

고객입니다.

JSON 표현

JSON 표현
{ "resourceName": string, "callReportingSetting": { object (`CallReportingSetting`) }, "conversionTrackingSetting": { object (`ConversionTrackingSetting`) }, "remarketingSetting": { object (`RemarketingSetting`) }, "payPerConversionEligibilityFailureReasons": [ enum (`CustomerPayPerConversionEligibilityFailureReason`) ], "optimizationScoreWeight": number, "status": enum (`CustomerStatus`), "offlineConversionClientSummaries": [ { object (`OfflineConversionClientSummary`) } ], "customerAgreementSetting": { object (`CustomerAgreementSetting`) }, "id": string, "descriptiveName": string, "currencyCode": string, "timeZone": string, "trackingUrlTemplate": string, "finalUrlSuffix": string, "autoTaggingEnabled": boolean, "hasPartnersBadge": boolean, "manager": boolean, "testAccount": boolean, "optimizationScore": number, "locationAssetAutoMigrationDone": boolean, "imageAssetAutoMigrationDone": boolean, "locationAssetAutoMigrationDoneDateTime": string, "imageAssetAutoMigrationDoneDateTime": string }

{
  "resourceName": string,
  "callReportingSetting": {
    object (CallReportingSetting)
  },
  "conversionTrackingSetting": {
    object (ConversionTrackingSetting)
  },
  "remarketingSetting": {
    object (RemarketingSetting)
  },
  "payPerConversionEligibilityFailureReasons": [
    enum (CustomerPayPerConversionEligibilityFailureReason)
  ],
  "optimizationScoreWeight": number,
  "status": enum (CustomerStatus),
  "offlineConversionClientSummaries": [
    {
      object (OfflineConversionClientSummary)
    }
  ],
  "customerAgreementSetting": {
    object (CustomerAgreementSetting)
  },
  "id": string,
  "descriptiveName": string,
  "currencyCode": string,
  "timeZone": string,
  "trackingUrlTemplate": string,
  "finalUrlSuffix": string,
  "autoTaggingEnabled": boolean,
  "hasPartnersBadge": boolean,
  "manager": boolean,
  "testAccount": boolean,
  "optimizationScore": number,
  "locationAssetAutoMigrationDone": boolean,
  "imageAssetAutoMigrationDone": boolean,
  "locationAssetAutoMigrationDoneDateTime": string,
  "imageAssetAutoMigrationDoneDateTime": string
}

필드
`resourceName`	`string` 변경할 수 없습니다. 고객의 리소스 이름입니다. 고객 리소스 이름의 형식은 다음과 같습니다. `customers/{customerId}`
`callReportingSetting`	`object (CallReportingSetting)` 고객의 통화 보고서 설정 `update` 작업에서만 변경 가능합니다.
`conversionTrackingSetting`	`object (ConversionTrackingSetting)` 출력 전용. 고객에 대한 전환 추적 설정
`remarketingSetting`	`object (RemarketingSetting)` 출력 전용. 고객의 리마케팅 설정입니다.
`payPerConversionEligibilityFailureReasons[]`	`enum (CustomerPayPerConversionEligibilityFailureReason)` 출력 전용. 고객이 PaymentMode.CONVERSIONS를 사용할 수 없는 이유입니다. 목록이 비어 있으면 고객이 자격을 갖춘 것입니다. 이 필드는 읽기 전용입니다.
`optimizationScoreWeight`	`number` 출력 전용. 고객의 최적화 점수 가중치입니다. 최적화 점수 가중치는 여러 비관리자 고객의 최적화 점수를 비교/집계하는 데 사용할 수 있습니다. 관리자의 집계 최적화 점수는 `Customer.optimization_score * Customer.optimization_score_weight`의 모든 고객에 대한 합계로 계산됩니다. 이 필드는 모든 관리자 고객과 점수가 없는 비관리자 고객의 경우 0입니다. 이 필드는 읽기 전용입니다.
`status`	`enum (CustomerStatus)` 출력 전용. 고객의 상태입니다.
`offlineConversionClientSummaries[]`	`object (OfflineConversionClientSummary)` 출력 전용. 오프라인 전환 업로드 진단입니다.
`customerAgreementSetting`	`object (CustomerAgreementSetting)` 출력 전용. 고객의 고객 동의 설정
`id`	`string (int64 format)` 출력 전용. 고객의 ID입니다.
`descriptiveName`	`string` 고객에 대해 선택적이고 고유하지 않은 설명이 포함된 이름입니다.
`currencyCode`	`string` 변경할 수 없습니다. 계정에 사용되는 통화입니다. ISO 4217 표준의 통화 코드 중 일부가 지원됩니다.
`timeZone`	`string` 변경할 수 없습니다. 고객의 현지 시간대 ID입니다.
`trackingUrlTemplate`	`string` 매개변수로 추적 URL을 작성하기 위한 URL 템플릿입니다. `update` 작업에서만 변경 가능합니다.
`finalUrlSuffix`	`string` 최종 URL에 매개변수를 추가하기 위한 URL 템플릿입니다. `update` 작업에서만 변경 가능합니다.
`autoTaggingEnabled`	`boolean` 고객에 대해 자동 태그 추가의 사용 설정 여부입니다.
`hasPartnersBadge`	`boolean` 출력 전용. '고객'의 파트너 프로그램 배지 보유 여부 '고객'이 파트너 프로그램과 연결되어 있지 않은 경우 이는 거짓입니다. 자세한 내용은 https://support.google.com/partners/answer/3125774를 참고하세요.
`manager`	`boolean` 출력 전용. 고객이 관리자인지 여부입니다.
`testAccount`	`boolean` 출력 전용. 고객이 테스트 계정인지 여부
`optimizationScore`	`number` 출력 전용. 고객의 최적화 점수입니다. 최적화 점수는 고객의 캠페인이 얼마나 좋은 실적을 낼 수 있을지를 추정한 수치입니다. 범위는 0% (0.0)~100% (1.0)입니다. 모든 관리자 고객과 점수가 없는 비 관리자 고객의 경우 이 필드는 null입니다. https://support.google.com/google-ads/answer/9061546에서 '최적화 점수 정보'를 참조하세요. 이 필드는 읽기 전용입니다.
`locationAssetAutoMigrationDone`	`boolean` 출력 전용. 피드 기반 위치가 확장 소재 기반 위치로 이전된 경우 true입니다.
`imageAssetAutoMigrationDone`	`boolean` 출력 전용. 피드 기반 이미지가 확장 소재 기반 이미지로 이전된 경우 true입니다.
`locationAssetAutoMigrationDoneDateTime`	`string` 출력 전용. 피드 기반 위치에서 애셋 기본 위치로의 이전 타임스탬프(yyyy-MM-dd HH:mm:ss 형식).
`imageAssetAutoMigrationDoneDateTime`	`string` 출력 전용. yyyy-MM-dd HH:mm:ss 형식의 피드 기반 이미지에서 애셋 기본 이미지로의 이전 타임스탬프입니다.

CallReportingSetting

고객의 통화 보고서 설정 update 작업에서만 변경 가능합니다.

JSON 표현
{ "callReportingEnabled": boolean, "callConversionReportingEnabled": boolean, "callConversionAction": string }

필드

필드
`callReportingEnabled`	`boolean` Google 시스템을 통해 전화 통화 이벤트를 리디렉션하여 보고하도록 설정합니다.
`callConversionReportingEnabled`	`boolean` 통화 전환 보고의 사용 설정 여부입니다.
`callConversionAction`	`string` 통화 전환에 대한 기여도를 부여할 고객 수준 통화 전환 액션입니다. 설정하지 않으면 기본 전환 액션이 사용됩니다. callConversionReportingEnabled가 true로 설정된 경우에만 적용됩니다.

callReportingEnabled

boolean

Google 시스템을 통해 전화 통화 이벤트를 리디렉션하여 보고하도록 설정합니다.

callConversionReportingEnabled

boolean

통화 전환 보고의 사용 설정 여부입니다.

callConversionAction

string

통화 전환에 대한 기여도를 부여할 고객 수준 통화 전환 액션입니다. 설정하지 않으면 기본 전환 액션이 사용됩니다. callConversionReportingEnabled가 true로 설정된 경우에만 적용됩니다.

ConversionTrackingSetting

Google Ads 전환 추적과 관련된 고객 전체 설정의 모음입니다.

JSON 표현

JSON 표현
{ "acceptedCustomerDataTerms": boolean, "conversionTrackingStatus": enum (`ConversionTrackingStatus`), "enhancedConversionsForLeadsEnabled": boolean, "googleAdsConversionCustomer": string, "conversionTrackingId": string, "crossAccountConversionTrackingId": string }

{
  "acceptedCustomerDataTerms": boolean,
  "conversionTrackingStatus": enum (ConversionTrackingStatus),
  "enhancedConversionsForLeadsEnabled": boolean,
  "googleAdsConversionCustomer": string,
  "conversionTrackingId": string,
  "crossAccountConversionTrackingId": string
}

필드
`acceptedCustomerDataTerms`	`boolean` 출력 전용. 고객이 고객 데이터 약관에 동의했는지 여부입니다. 교차 계정 전환 추적을 사용하는 경우 관리자로부터 이 값이 상속됩니다. 이 필드는 읽기 전용입니다. 자세한 내용은 다음 페이지를 참고하세요.https://support.google.com/adspolicy/answer/7475709
`conversionTrackingStatus`	`enum (ConversionTrackingStatus)` 출력 전용. 전환 추적 상태 고객이 전환 추적을 사용하고 있는지, 그리고 이 고객의 전환 추적 소유자가 누구인지를 나타냅니다. 이 고객이 교차 계정 전환 추적을 사용 중인 경우 반환되는 값은 요청의 `login-customer-id`에 따라 달라집니다.
`enhancedConversionsForLeadsEnabled`	`boolean` 출력 전용. 고객이 리드 확보용 향상된 전환을 선택했는지 여부 교차 계정 전환 추적을 사용하는 경우 관리자로부터 이 값이 상속됩니다. 이 필드는 읽기 전용입니다.
`googleAdsConversionCustomer`	`string` 출력 전용. 전환이 생성되고 관리되는 고객의 리소스 이름입니다. 이 필드는 읽기 전용입니다.
`conversionTrackingId`	`string (int64 format)` 출력 전용. 이 계정에 사용된 전환 추적 ID입니다. 이 ID는 고객이 전환 추적을 사용하는지 여부를 나타내지 않습니다 (conversionTrackingStatus). 이 필드는 읽기 전용입니다.
`crossAccountConversionTrackingId`	`string (int64 format)` 출력 전용. 고객 관리자의 전환 추적 ID입니다. 고객이 교차 계정 전환 추적을 선택한 경우 설정되며 conversionTrackingId보다 우선 적용됩니다. 이 필드는 Google Ads UI를 통해서만 관리할 수 있습니다. 이 필드는 읽기 전용입니다.

ConversionTrackingStatus

고객의 전환 추적 상태입니다.

열거형
`UNSPECIFIED`	지정되지 않음
`UNKNOWN`	반환 값에만 사용됩니다. 이 버전에서 알 수 없는 값을 나타냅니다.
`NOT_CONVERSION_TRACKED`	고객이 전환 추적을 사용하지 않습니다.
`CONVERSION_TRACKING_MANAGED_BY_SELF`	전환 액션은 이 고객이 만들고 관리합니다.
`CONVERSION_TRACKING_MANAGED_BY_THIS_MANAGER`	전환 액션은 요청의 `login-customer-id`에 지정된 관리자가 만들고 관리합니다.
`CONVERSION_TRACKING_MANAGED_BY_ANOTHER_MANAGER`	전환 액션은 요청의 `login-customer-id`에 지정된 고객 또는 관리자가 아닌 관리자가 만들고 관리합니다.

RemarketingSetting

고객의 리마케팅 설정입니다.

JSON 표현
{ "googleGlobalSiteTag": string }

필드

필드
`googleGlobalSiteTag`	`string` 출력 전용. Google 태그

googleGlobalSiteTag

string

출력 전용. Google 태그

CustomerPayPerConversionEligibilityFailureReason

고객이 PaymentMode.CONVERSIONS를 사용할 수 없는 가능한 이유를 설명하는 열거형입니다.

열거형
`UNSPECIFIED`	지정되지 않음
`UNKNOWN`	반환 값에만 사용됩니다. 이 버전에서 알 수 없는 값을 나타냅니다.
`NOT_ENOUGH_CONVERSIONS`	고객의 전환수가 충분하지 않습니다.
`CONVERSION_LAG_TOO_HIGH`	고객의 전환 지연시간이 너무 높습니다.
`HAS_CAMPAIGN_WITH_SHARED_BUDGET`	고객이 공유 예산을 사용합니다.
`HAS_UPLOAD_CLICKS_CONVERSION`	고객에게 ConversionActionType.UPLOAD_clicks의 전환이 발생했습니다.
`AVERAGE_DAILY_SPEND_TOO_HIGH`	고객의 평균 일일 지출이 너무 높습니다.
`ANALYSIS_NOT_COMPLETE`	Google Ads 백엔드에서 고객의 자격 여부를 아직 계산하지 않았습니다. 나중에 다시 확인해 주세요.
`OTHER`	고객이 기타 이유로 자격 요건을 충족하지 않습니다.

OfflineConversionClientSummary

클라이언트가 요약한 오프라인 전환 업로드 진단입니다. 이 프로토콜에는 일반 정보, 날짜/작업별 분류, 오프라인 전환 업로드 결과에 대한 알림이 포함됩니다.

JSON 표현

JSON 표현
{ "client": enum (`OfflineEventUploadClient`), "status": enum (`OfflineConversionDiagnosticStatus`), "totalEventCount": string, "successfulEventCount": string, "successRate": number, "lastUploadDateTime": string, "dailySummaries": [ { object (`OfflineConversionUploadSummary`) } ], "jobSummaries": [ { object (`OfflineConversionUploadSummary`) } ], "alerts": [ { object (`OfflineConversionUploadAlert`) } ] }

{
  "client": enum (OfflineEventUploadClient),
  "status": enum (OfflineConversionDiagnosticStatus),
  "totalEventCount": string,
  "successfulEventCount": string,
  "successRate": number,
  "lastUploadDateTime": string,
  "dailySummaries": [
    {
      object (OfflineConversionUploadSummary)
    }
  ],
  "jobSummaries": [
    {
      object (OfflineConversionUploadSummary)
    }
  ],
  "alerts": [
    {
      object (OfflineConversionUploadAlert)
    }
  ]
}

필드
`client`	`enum (OfflineEventUploadClient)` 출력 전용. 업로드 이벤트의 클라이언트 유형입니다.
`status`	`enum (OfflineConversionDiagnosticStatus)` 출력 전용. 오프라인 전환 고객 요약의 전반적인 상태입니다. 상태는 업로드 통계가 있는 가장 최근 날짜를 기준으로 생성됩니다.
`totalEventCount`	`string (int64 format)` 출력 전용. 업로드된 총 이벤트 수입니다.
`successfulEventCount`	`string (int64 format)` 출력 전용. 성공적으로 업로드된 총 이벤트 수입니다.
`successRate`	`number` 출력 전용. 성공률입니다.
`lastUploadDateTime`	`string` 출력 전용. 최신 업로드 배치의 날짜입니다.
`dailySummaries[]`	`object (OfflineConversionUploadSummary)` 출력 전용. 지난 N일별 기록 통계 요약입니다.
`jobSummaries[]`	`object (OfflineConversionUploadSummary)` 출력 전용. 최근 N개 작업별 기록 통계 요약입니다.
`alerts[]`	`object (OfflineConversionUploadAlert)` 출력 전용. 각 오류 코드의 세부정보입니다. 알림은 업로드 통계가 있는 가장 최근 날짜에서 생성됩니다.

OfflineEventUploadClient

클라이언트의 유형입니다.

열거형
`UNSPECIFIED`	지정되지 않음
`UNKNOWN`	반환 값에만 사용됩니다. 이 버전에서 알 수 없는 값을 나타냅니다.
`GOOGLE_ADS_API`	Google Ads API입니다.
`GOOGLE_ADS_WEB_CLIENT`	Google Ads 웹 클라이언트. Google Ads UI, SFTP 등 여러 소스를 포함할 수 있습니다.
`ADS_DATA_CONNECTOR`	연결 플랫폼입니다.

OfflineConversionDiagnosticStatus

오프라인 처리 설정의 가능한 상태입니다.

열거형
`UNSPECIFIED`	지정되지 않음
`UNKNOWN`	반환 값에만 사용됩니다. 이 버전에서 알 수 없는 값을 나타냅니다.
`EXCELLENT`	오프라인 데이터 수집 설정이 활성 상태이며 다운스트림 처리에 최적화되어 있습니다.
`GOOD`	오프라인 처리 설정이 활성 상태이지만, 추가로 개선할 수 있는 부분이 있습니다. 알림을 확인하세요.
`NEEDS_ATTENTION`	오프라인 처리 설정이 활성 상태이지만, 주의가 필요한 오류가 있습니다. 알림을 확인하세요.
`NO_RECENT_UPLOAD`	오프라인 처리 설정에서 지난 28일 동안 데이터를 받지 못했습니다. 문제가 있을 수 있습니다.

OfflineConversionUploadSummary

업로드 날짜 또는 작업별로 그룹화된 이전 업로드 요약입니다.

JSON 표현

JSON 표현
{ "successfulCount": string, "failedCount": string, // Union field `dimension_key` can be only one of the following: "jobId": string, "uploadDate": string // End of list of possible types for union field `dimension_key`. }

{
  "successfulCount": string,
  "failedCount": string,

  // Union field dimension_key can be only one of the following:
  "jobId": string,
  "uploadDate": string
  // End of list of possible types for union field dimension_key.
}

필드
`successfulCount`	`string (int64 format)` 출력 전용. 성공한 총 이벤트 수입니다.
`failedCount`	`string (int64 format)` 출력 전용. 실패한 이벤트의 총 개수입니다.
통합 필드 `dimension_key`. 요약을 위한 측정기준 키 `dimension_key`은 다음 중 하나여야 합니다.
`jobId`	`string (int64 format)` 출력 전용. 마지막 N개 작업의 측정기준 키입니다.
`uploadDate`	`string` 출력 전용. 지난 N일 동안의 측정기준 키입니다.

OfflineConversionUploadAlert

오프라인 전환 고객 요약 알림입니다.

JSON 표현
{ "error": { object (`OfflineConversionUploadError`) }, "errorPercentage": number }

필드

필드
`error`	`object (OfflineConversionUploadError)` 출력 전용. 오프라인 전환 고객 알림에 오류가 발생했습니다.
`errorPercentage`	`number` 출력 전용. 오류의 백분율입니다.

error

object (OfflineConversionUploadError)

출력 전용. 오프라인 전환 고객 알림에 오류가 발생했습니다.

errorPercentage

number

출력 전용. 오류의 백분율입니다.

OfflineConversionUploadError

오프라인 전환 고객 요약에 오류가 있을 수 있습니다.

JSON 표현

JSON 표현
{ // Union field `error_code` can be only one of the following: "collectionSizeError": enum (`CollectionSizeError`), "conversionAdjustmentUploadError": enum (`ConversionAdjustmentUploadError`), "conversionUploadError": enum (`ConversionUploadError`), "dateError": enum (`DateError`), "distinctError": enum (`DistinctError`), "fieldError": enum (`FieldError`), "mutateError": enum (`MutateError`), "notAllowlistedError": enum (`NotAllowlistedError`), "stringFormatError": enum (`StringFormatError`), "stringLengthError": enum (`StringLengthError`) // End of list of possible types for union field `error_code`. }

{

  // Union field error_code can be only one of the following:
  "collectionSizeError": enum (CollectionSizeError),
  "conversionAdjustmentUploadError": enum (ConversionAdjustmentUploadError),
  "conversionUploadError": enum (ConversionUploadError),
  "dateError": enum (DateError),
  "distinctError": enum (DistinctError),
  "fieldError": enum (FieldError),
  "mutateError": enum (MutateError),
  "notAllowlistedError": enum (NotAllowlistedError),
  "stringFormatError": enum (StringFormatError),
  "stringLengthError": enum (StringLengthError)
  // End of list of possible types for union field error_code.
}

필드
통합 필드 `error_code`. 설명에 오류가 있습니다. `error_code`은 다음 중 하나여야 합니다.
`collectionSizeError`	`enum (CollectionSizeError)` 출력 전용. 컬렉션 크기 오류입니다.
`conversionAdjustmentUploadError`	`enum (ConversionAdjustmentUploadError)` 출력 전용. 전환 조정 업로드 오류입니다.
`conversionUploadError`	`enum (ConversionUploadError)` 출력 전용. 전환 업로드 오류입니다.
`dateError`	`enum (DateError)` 출력 전용. 날짜 오류입니다.
`distinctError`	`enum (DistinctError)` 출력 전용. 고유한 오류입니다.
`fieldError`	`enum (FieldError)` 출력 전용. 입력란에 오류가 있습니다.
`mutateError`	`enum (MutateError)` 출력 전용. 변형 오류입니다.
`notAllowlistedError`	`enum (NotAllowlistedError)` 출력 전용. 허용 목록에 없는 오류입니다.
`stringFormatError`	`enum (StringFormatError)` 출력 전용. 문자열 형식 오류입니다.
`stringLengthError`	`enum (StringLengthError)` 출력 전용. 문자열 길이 오류입니다.

CollectionSizeError

가능한 컬렉션 크기 오류를 설명하는 열거형입니다.

열거형
`UNSPECIFIED`	열거형이 지정되지 않았습니다.
`UNKNOWN`	수신된 오류 코드를 이 버전에서 알 수 없습니다.
`TOO_FEW`	너무 적습니다.
`TOO_MANY`	너무 많습니다.

ConversionAdjustmentUploadError

발생 가능한 전환 조정 업로드 오류를 설명하는 열거형입니다.

열거형
`UNSPECIFIED`	지정되지 않음
`UNKNOWN`	반환 값에만 사용됩니다. 이 버전에서 알 수 없는 값을 나타냅니다.
`TOO_RECENT_CONVERSION_ACTION`	방금 생성된 전환 액션으로는 이벤트를 가져올 수 없습니다. 6시간 후에 가져오기를 다시 시도하세요.
`INVALID_CONVERSION_ACTION`	조정할 수 있는 활성 전환 액션을 지정해야 합니다.
`CONVERSION_ALREADY_RETRACTED`	전환이 이미 철회되었습니다. 조정이 처리되지 않았습니다.
`CONVERSION_NOT_FOUND`	이 전환 액션 및 전환 식별자의 전환을 찾을 수 없습니다. 전환 식별자가 올바른 전환 액션과 연결되어 있는지 확인한 후 다시 시도해 주세요.
`CONVERSION_EXPIRED`	54일 이전에 발생한 전환은 조정할 수 없습니다.
`ADJUSTMENT_PRECEDES_CONVERSION`	조정에 연결된 전환 전에 발생한 `adjustmentDateTime`이(가) 있습니다. `adjustmentDateTime`이(가) 올바른지 확인한 후 다시 시도해 주세요.
`MORE_RECENT_RESTATEMENT_FOUND`	관련 전환에 대한 최근 조정(`adjustmentDateTime`)이 이미 보고되었습니다. 조정값(`adjustmentDateTime`)이 올바른지 확인한 후 다시 시도하세요.
`TOO_RECENT_CONVERSION`	너무 최근에 전환이 발생하여 조정을 기록할 수 없습니다. 최소 24시간 전에 발생한 전환을 조정해 보세요.
`CANNOT_RESTATE_CONVERSION_ACTION_THAT_ALWAYS_USES_DEFAULT_CONVERSION_VALUE`	기본값을 사용하도록 설정된 전환은 조정할 수 없습니다. 전환 액션 값 설정을 확인한 후 다시 시도해 주세요.
`TOO_MANY_ADJUSTMENTS_IN_REQUEST`	단일 API 요청으로 업로드하는 조정의 수를 2001개 미만으로 하세요.
`TOO_MANY_ADJUSTMENTS`	전환이 이미 최대 횟수로 조정되었습니다. 기존 전환을 필요한 만큼만 조정하시기 바랍니다.
`RESTATEMENT_ALREADY_EXISTS`	동일한 `adjustmentDateTime`을(를) 사용해 다시 수정하기 전에 전환이 발생했습니다. 조정에 정확하고 고유한 `adjustmentDateTime`이(가) 있는지 확인한 후 다시 시도하세요.
`DUPLICATE_ADJUSTMENT_IN_REQUEST`	가져온 조정에 동일한 `adjustmentDateTime`을(를) 가진 중복 전환 조정이 있습니다. 조정에 올바른 `adjustmentDateTime`이(가) 있는지 확인한 후 다시 시도해 주세요.
`CUSTOMER_NOT_ACCEPTED_CUSTOMER_DATA_TERMS`	전환 설정에서 고객 데이터 처리 약관에 동의하고 다시 시도해 주세요.
`CONVERSION_ACTION_NOT_ELIGIBLE_FOR_ENHANCEMENT`	지정된 전환 액션으로는 향상된 전환을 사용할 수 없습니다.
`INVALID_USER_IDENTIFIER`	SHA-256을 사용하여 사용자 제공 데이터를 해싱하고 가이드라인에 따라 정규화하고 있는지 확인하세요.
`UNSUPPORTED_USER_IDENTIFIER`	SHA-256을 사용하여 해싱된 이메일 또는 전화번호와 같은 사용자 제공 데이터를 사용하고 다시 시도하세요.
`GCLID_DATE_TIME_PAIR_AND_ORDER_ID_BOTH_SET`	gclidDateTimePair와 orderId를 모두 설정할 수 없습니다. 유형 1개만 사용하고 다시 시도하세요.
`CONVERSION_ALREADY_ENHANCED`	전환에 주문 ID 및 전환 액션이 동일한 개선 사항이 이미 있습니다. 데이터가 올바르게 구성되었는지 확인한 후 다시 시도해 주세요.
`DUPLICATE_ENHANCEMENT_IN_REQUEST`	전환 액션과 주문 ID가 동일한 개선 사항이 여러 개 있습니다. 데이터가 올바르게 구성되었는지 확인한 후 다시 시도해 주세요.
`CUSTOMER_DATA_POLICY_PROHIBITS_ENHANCEMENT`	Google 고객 데이터 정책으로 인해 향상된 전환을 사용할 수 없는 계정입니다. Google 담당자에게 문의하세요.
`MISSING_ORDER_ID_FOR_WEBPAGE`	웹사이트 전환을 조정하려면 주문 ID (예: 거래 ID)가 필요합니다. 웹사이트 태그에서 주문 ID를 포착하고 조정과 함께 동일한 주문 ID를 전송해야 합니다.
`ORDER_ID_CONTAINS_PII`	개인 식별 정보 (PII)가 포함된 주문 ID로는 조정을 사용할 수 없습니다.

ConversionUploadError

발생할 수 있는 전환 업로드 오류를 설명하는 열거형입니다.

열거형
`UNSPECIFIED`	열거형이 지정되지 않았습니다.
`UNKNOWN`	반환 값에만 사용됩니다. 이 버전에서 알 수 없는 값을 나타냅니다.
`TOO_MANY_CONVERSIONS_IN_REQUEST`	단일 요청으로 이벤트를 2,001개 미만으로 업로드합니다.
`UNPARSEABLE_GCLID`	가져온 GCLID를 디코딩할 수 없습니다. 클릭 ID를 수정하지 않았는지 확인하세요.
`CONVERSION_PRECEDES_EVENT`	가져온 이벤트의 클릭 앞에 `conversionDateTime`이(가) 있습니다. `conversionDateTime`이(가) 올바른지 확인한 후 다시 시도해 주세요.
`EXPIRED_EVENT`	전환의 클릭연결 기간 전에 클릭이 발생했으므로 가져온 이벤트를 기록할 수 없습니다. 최신 데이터를 가져와야 합니다.
`TOO_RECENT_EVENT`	해당 식별자 또는 iOS URL 매개변수와 관련된 클릭이 발생한 지 6시간이 지나지 않았습니다. 6시간이 지난 후 다시 시도하세요.
`EVENT_NOT_FOUND`	클릭이 가져온 이벤트에 기여했다고 간주할 수 없습니다. 이는 Google Ads 캠페인에서 발생한 이벤트가 아니기 때문일 수 있습니다.
`UNAUTHORIZED_CUSTOMER`	클릭 ID 또는 통화가 액세스 권한이 없는 Google Ads 계정과 연결되어 있습니다. 관리자 계정에서 관리하는 계정의 전환을 가져와야 합니다.
`INVALID_CONVERSION_ACTION`	오프라인 가져오기에 대해 설정된 올바른 전환 액션을 지정해야 합니다.
`TOO_RECENT_CONVERSION_ACTION`	방금 생성된 전환 액션으로는 이벤트를 가져올 수 없습니다. 6시간 후에 가져오기를 다시 시도하세요.
`CONVERSION_TRACKING_NOT_ENABLED_AT_IMPRESSION_TIME`	클릭 당시 해당 클릭이 발생한 Google Ads 계정의 유효 전환 계정에 전환 추적이 사용 설정되어 있지 않았습니다.
`EXTERNAL_ATTRIBUTION_DATA_SET_FOR_NON_EXTERNALLY_ATTRIBUTED_CONVERSION_ACTION`	가져온 이벤트에 외부 기여 분석 데이터가 포함되어 있지만 전환 액션이 외부 기여 분석 모델을 사용하도록 설정되지 않았습니다. 전환 액션이 올바르게 구성되어 있는지 확인한 후 다시 시도해 주세요.
`EXTERNAL_ATTRIBUTION_DATA_NOT_SET_FOR_EXTERNALLY_ATTRIBUTED_CONVERSION_ACTION`	외부 기여 분석 모델을 사용하도록 전환 액션이 설정되어 있지만, 가져온 이벤트에 데이터가 누락되었습니다. 가져온 이벤트에 외부 기여도와 모든 필수 필드가 포함되어 있는지 확인하세요.
`ORDER_ID_NOT_PERMITTED_FOR_EXTERNALLY_ATTRIBUTED_CONVERSION_ACTION`	외부 기여 분석 모델로 측정할 때는 주문 ID를 사용할 수 없습니다. 전환이 올바르게 구성되고 가져온 이벤트에 필요한 데이터만 포함되었는지 확인한 후 다시 시도하세요.
`ORDER_ID_ALREADY_IN_USE`	가져온 이벤트에 이전에 기록된 주문 ID가 포함되어 있어 이벤트가 처리되지 않았습니다.
`DUPLICATE_ORDER_ID`	가져온 이벤트에 주문 ID가 동일한 전환이 여러 개 포함되어 있어 처리되지 않았습니다. 주문 ID가 고유한지 확인한 후 다시 시도해 주세요.
`TOO_RECENT_CALL`	6시간이 지나지 않은 통화는 가져올 수 없습니다. 6시간 후에 다시 업로드해 보세요.
`EXPIRED_CALL`	이 전환 액션의 전환 확인 기간 이전에 발생했으므로 통화를 기록할 수 없습니다. 최신 데이터를 가져오도록 가져오기가 구성되어 있는지 확인하세요.
`CALL_NOT_FOUND`	가져온 이벤트로 연결되는 호출 또는 클릭을 찾을 수 없습니다. 데이터 소스가 올바른 식별자를 포함하도록 설정되어 있는지 확인하세요.
`CONVERSION_PRECEDES_CALL`	호출에 연결된 클릭 앞에 `conversionDateTime`가 있습니다. `conversionDateTime`이(가) 올바른지 확인하세요.
`CONVERSION_TRACKING_NOT_ENABLED_AT_CALL_TIME`	통화를 가져올 때 클릭이 발생한 Google Ads 계정의 유효 전환 계정에서 전환 추적이 사용 설정되지 않았습니다.
`UNPARSEABLE_CALLERS_PHONE_NUMBER`	전화번호는 E.164 (+16502531234), 국제 전화 (+64 3-331 6005) 또는 미국 국가 전화번호 (6502531234) 형식이어야 합니다.
`CLICK_CONVERSION_ALREADY_EXISTS`	가져온 이벤트의 클릭수 및 `conversionDateTime`이 기존 전환과 동일합니다. 고유한 이벤트별로 고유한 `conversionDateTime` 또는 주문 ID를 사용하여 다시 시도하세요.
`CALL_CONVERSION_ALREADY_EXISTS`	가져온 통화의 `conversionDateTime`이(가) 기존 전환과 동일합니다. `conversionDateTime`이(가) 올바르게 구성되었는지 확인한 후 다시 시도해 주세요.
`DUPLICATE_CLICK_CONVERSION_IN_REQUEST`	클릭과 `conversionDateTime`이 같은 이벤트가 여러 개 있습니다. `conversionDateTime`이(가) 올바르게 구성되어 있는지 확인한 후 다시 시도해 주세요.
`DUPLICATE_CALL_CONVERSION_IN_REQUEST`	여러 이벤트에 동일한 호출과 `conversionDateTime`가 있습니다. `conversionDateTime`이(가) 올바르게 구성되어 있는지 확인한 후 다시 시도해 주세요.
`CUSTOM_VARIABLE_NOT_ENABLED`	전환 설정에서 맞춤 변수를 사용 설정한 후 다시 시도하세요.
`CUSTOM_VARIABLE_VALUE_CONTAINS_PII`	개인 식별 정보 (PII)가 포함된 맞춤 변수가 있는 이벤트는 가져올 수 없습니다. 이러한 변수를 삭제하고 다시 시도하세요.
`INVALID_CUSTOMER_FOR_CLICK`	가져온 이벤트의 클릭이 다른 Google Ads 계정과 연결되어 있습니다. 가져오는 계정이 올바른지 확인하세요.
`INVALID_CUSTOMER_FOR_CALL`	통화에서 발생한 클릭이 다른 Google Ads 계정과 연결되어 있습니다. 가져오는 계정이 올바른지 확인하세요. 고객에서 conversionTrackingSetting.google_ads_conversion_customer를 쿼리하여 올바른 계정을 식별합니다.
`CONVERSION_NOT_COMPLIANT_WITH_ATT_POLICY`	전환 소스가 Apple 앱 투명성 추적 (ATT) 정책을 준수하지 않거나 고객이 추적에 동의하지 않았기 때문에 전환을 가져올 수 없습니다.
`CLICK_NOT_FOUND`	이 이벤트의 이메일 주소 또는 전화번호와 매칭되는 클릭이 없습니다. 이는 Google Ads 캠페인에서 발생한 클릭이 아니기 때문일 수 있으며, 이 경고는 무시해도 됩니다. 가져온 이벤트가 예상보다 많이 포함되어 있으면 설정을 확인해 보세요.
`INVALID_USER_IDENTIFIER`	SHA-256을 사용하여 사용자 제공 데이터를 해싱하고 가이드라인에 따라 정규화하고 있는지 확인하세요.
`EXTERNALLY_ATTRIBUTED_CONVERSION_ACTION_NOT_PERMITTED_WITH_USER_IDENTIFIER`	사용자 제공 데이터는 외부 기여 분석 모델과 함께 사용할 수 없습니다. 다른 기여 분석 모델을 사용하거나 사용자 식별자를 생략한 후 다시 시도해 주세요.
`UNSUPPORTED_USER_IDENTIFIER`	제공된 사용자 식별자가 지원되지 않습니다. 해싱된 이메일 또는 전화번호만 사용하고 다시 시도해 주세요.
`GBRAID_WBRAID_BOTH_SET`	GBRAID 매개변수와 WBRAID 매개변수를 동시에 사용할 수는 없습니다. 1개만 사용하고 다시 시도하세요.
`UNPARSEABLE_WBRAID`	이벤트 가져오기 데이터를 파싱할 수 없습니다. wbraid 매개변수가 수정되지 않았는지 확인한 후 다시 시도하세요.
`UNPARSEABLE_GBRAID`	이벤트 가져오기 데이터를 파싱할 수 없습니다. GBRAID 매개변수가 수정되지 않았는지 확인한 후 다시 시도해 주세요.
`ONE_PER_CLICK_CONVERSION_ACTION_NOT_PERMITTED_WITH_BRAID`	클릭당 1회의 전환만 집계하는 방식을 사용하는 전환 액션은 GBRAID 또는 WBRAID 매개변수와 함께 사용할 수 없습니다.
`CUSTOMER_DATA_POLICY_PROHIBITS_ENHANCED_CONVERSIONS`	Google 고객 데이터 정책으로 인해 향상된 전환을 사용할 수 없는 계정입니다. Google 담당자에게 문의하세요.
`CUSTOMER_NOT_ACCEPTED_CUSTOMER_DATA_TERMS`	전환 설정에서 고객 데이터 처리 약관에 동의하고 다시 시도해 주세요. '고객'에 대해 conversionTrackingSetting.accepted_customer_data_terms를 쿼리하여 설정을 확인할 수 있습니다.
`ORDER_ID_CONTAINS_PII`	주문 ID에 개인 식별 정보 (PII)가 포함된 이벤트는 가져올 수 없습니다.
`CUSTOMER_NOT_ENABLED_ENHANCED_CONVERSIONS_FOR_LEADS`	전환 설정에서 리드 확보용 향상된 전환을 사용 설정했는지 확인하고 다시 시도해 주세요. 고객에 대해 conversionTrackingSetting.enhanced_conversions_for_leads_enabled를 쿼리하여 설정을 확인할 수 있습니다.

DateError

발생할 수 있는 날짜 오류를 설명하는 열거형입니다.

열거형
`UNSPECIFIED`	열거형이 지정되지 않았습니다.
`UNKNOWN`	수신된 오류 코드를 이 버전에서 알 수 없습니다.
`INVALID_FIELD_VALUES_IN_DATE`	제공된 필드 값이 올바른 날짜와 일치하지 않습니다.
`INVALID_FIELD_VALUES_IN_DATE_TIME`	제공된 필드 값이 올바른 날짜 시간과 일치하지 않습니다.
`INVALID_STRING_DATE`	날짜 문자열은 yyyy-mm-dd 형식이어야 합니다.
`INVALID_STRING_DATE_TIME_MICROS`	날짜/시간 문자열은 yyyy-mm-dd hh:mm:ss.ssssssssssssss여야 합니다.
`INVALID_STRING_DATE_TIME_SECONDS`	날짜/시간 문자열은 yyyy-mm-dd hh:mm:ss 형식이어야 합니다.
`INVALID_STRING_DATE_TIME_SECONDS_WITH_OFFSET`	날짜 시간 문자열은 yyyy-mm-dd hh:mm:ss+\|-hh:mm 형식이어야 합니다.
`EARLIER_THAN_MINIMUM_DATE`	허용되는 최솟값보다 이전 날짜입니다.
`LATER_THAN_MAXIMUM_DATE`	날짜가 허용되는 최댓값 이후입니다.
`DATE_RANGE_MINIMUM_DATE_LATER_THAN_MAXIMUM_DATE`	기간 경계가 올바르지 않습니다.
`DATE_RANGE_MINIMUM_AND_MAXIMUM_DATES_BOTH_NULL`	범위 내 두 날짜가 모두 null입니다.

DistinctError

발생할 수 있는 고유한 오류를 설명하는 열거형입니다.

열거형
`UNSPECIFIED`	열거형이 지정되지 않았습니다.
`UNKNOWN`	수신된 오류 코드를 이 버전에서 알 수 없습니다.
`DUPLICATE_ELEMENT`	중복된 요소입니다.
`DUPLICATE_TYPE`	유형이 중복되었습니다.

FieldError

발생할 수 있는 필드 오류를 설명하는 열거형입니다.

열거형
`UNSPECIFIED`	열거형이 지정되지 않았습니다.
`UNKNOWN`	수신된 오류 코드를 이 버전에서 알 수 없습니다.
`REQUIRED`	필수 입력란이 없습니다.
`IMMUTABLE_FIELD`	변경하려고 시도한 필드는 변경할 수 없습니다.
`INVALID_VALUE`	필드 값이 잘못되었습니다.
`VALUE_MUST_BE_UNSET`	이 필드는 설정할 수 없습니다.
`REQUIRED_NONEMPTY_LIST`	필수 반복 입력란이 비어 있습니다.
`FIELD_CANNOT_BE_CLEARED`	이 필드는 지울 수 없습니다.
`BLOCKED_VALUE`	필드 값이 이 필드의 차단 목록에 있습니다.
`FIELD_CAN_ONLY_BE_CLEARED`	지우기를 제외하고는 필드의 값을 수정할 수 없습니다.

MutateError

가능한 변경 오류를 설명하는 열거형입니다.

열거형
`UNSPECIFIED`	열거형이 지정되지 않았습니다.
`UNKNOWN`	수신된 오류 코드를 이 버전에서 알 수 없습니다.
`RESOURCE_NOT_FOUND`	요청한 리소스를 찾을 수 없습니다.
`ID_EXISTS_IN_MULTIPLE_MUTATES`	하나의 요청에서 동일한 리소스를 두 번 변경할 수 없습니다.
`INCONSISTENT_FIELD_VALUES`	필드의 내용이 동일한 데이터를 나타내는 다른 필드와 일치하지 않습니다.
`MUTATE_NOT_ALLOWED`	요청된 리소스에는 변형이 허용되지 않습니다.
`RESOURCE_NOT_IN_GOOGLE_ADS`	리소스가 Google Ads에 없습니다. 다른 광고 시스템에 속합니다.
`RESOURCE_ALREADY_EXISTS`	생성 중인 리소스가 이미 존재합니다.
`RESOURCE_DOES_NOT_SUPPORT_VALIDATE_ONLY`	이 리소스는 'validateOnly'와 함께 사용할 수 없습니다.
`OPERATION_DOES_NOT_SUPPORT_PARTIAL_FAILURE`	이 작업은 'partialFailure'와 함께 사용할 수 없습니다.
`RESOURCE_READ_ONLY`	읽기 전용 필드에 쓰기를 시도합니다.

NotAllowlistedError

허용 목록에 추가되지 않았을 가능성이 있는 오류를 설명하는 열거형입니다.

열거형
`UNSPECIFIED`	열거형이 지정되지 않았습니다.
`UNKNOWN`	수신된 오류 코드를 이 버전에서 알 수 없습니다.
`CUSTOMER_NOT_ALLOWLISTED_FOR_THIS_FEATURE`	고객이 이 기능에 액세스하도록 허용되어 있지 않습니다.

StringFormatError

가능한 문자열 형식 오류를 설명하는 열거형입니다.

열거형
`UNSPECIFIED`	열거형이 지정되지 않았습니다.
`UNKNOWN`	수신된 오류 코드를 이 버전에서 알 수 없습니다.
`ILLEGAL_CHARS`	입력 문자열 값에 허용되지 않는 문자가 포함되어 있습니다.
`INVALID_FORMAT`	연결된 필드의 입력 문자열 값이 잘못되었습니다.

StringLengthError

가능한 문자열 길이 오류를 설명하는 열거형입니다.

열거형
`UNSPECIFIED`	열거형이 지정되지 않았습니다.
`UNKNOWN`	수신된 오류 코드를 이 버전에서 알 수 없습니다.
`EMPTY`	지정된 필드에는 공백이 아닌 문자가 하나 이상 있어야 합니다.
`TOO_SHORT`	이름이 너무 짧습니다.
`TOO_LONG`	이름이 너무 깁니다.

CustomerAgreementSetting

고객의 고객 동의 설정

JSON 표현
{ "acceptedLeadFormTerms": boolean }

필드

필드
`acceptedLeadFormTerms`	`boolean` 출력 전용. 고객이 리드 양식 서비스 약관에 동의했는지 여부

acceptedLeadFormTerms

boolean

출력 전용. 고객이 리드 양식 서비스 약관에 동의했는지 여부