Customer

客户。

JSON 表示法 
{
  "resourceName": string,
  "callReportingSetting": {
    object (CallReportingSetting)
  },
  "conversionTrackingSetting": {
    object (ConversionTrackingSetting)
  },
  "remarketingSetting": {
    object (RemarketingSetting)
  },
  "payPerConversionEligibilityFailureReasons": [
    enum (CustomerPayPerConversionEligibilityFailureReason)
  ],
  "optimizationScoreWeight": number,
  "status": enum (CustomerStatus),
  "customerAgreementSetting": {
    object (CustomerAgreementSetting)
  },
  "localServicesSettings": {
    object (LocalServicesSettings)
  },
  "videoBrandSafetySuitability": enum (BrandSafetySuitability),
  "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)

仅限输出。客户的状态。
customerAgreementSetting

object (CustomerAgreementSetting)

仅限输出。客户的客户协议设置。
localServicesSettings

object (LocalServicesSettings)

仅限输出。本地生活服务客户的设置。
videoBrandSafetySuitability

enum (BrandSafetySuitability)

仅限输出。帐号一级的品牌保障设置。允许选择广告资源类型，以在适合您品牌的内容中展示您的广告。请参阅 https://support.google.com/google-ads/answer/7515513。
id

string (int64 format)

仅限输出。客户的 ID。
descriptiveName

string

（可选）客户的非唯一描述性名称。
currencyCode

string

不可变。账号采用的币种。支持 ISO 4217 标准中的一部分货币代码。
timeZone

string

不可变。客户的当地时区 ID。
trackingUrlTemplate

string

用于根据参数构建跟踪网址的网址模板。只有 update 操作中可变。
finalUrlSuffix

string

用于将参数附加到最终到达网址的网址模板。只有 update 操作中可变。
autoTaggingEnabled

boolean

是否为客户启用了自动标记功能。
hasPartnersBadge

boolean

仅限输出。客户是否拥有合作伙伴计划徽章。如果客户未与合作伙伴计划关联，此 ID 为 false。有关更多信息，请访问 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

仅限输出。如果基于 Feed 的地理位置已迁移到基于素材资源的地理位置，则为 true。
imageAssetAutoMigrationDone

boolean

仅限输出。如果基于 Feed 的图片已迁移到基于素材资源的图片，则为 true。
locationAssetAutoMigrationDoneDateTime

string

仅限输出。从基于 Feed 的位置到资产基准位置的迁移时间戳，采用 yyyy-MM-dd HH:mm:ss 格式。
imageAssetAutoMigrationDoneDateTime

string

仅限输出。从基于 Feed 的图片到资产基础图片的迁移时间戳，采用 yyyy-MM-dd HH:mm:ss 格式。

CallReportingSetting

客户的广告来电统计报告设置。只有 update 操作中可变。

JSON 表示法 
{
  "callReportingEnabled": boolean,
  "callConversionReportingEnabled": boolean,
  "callConversionAction": string
}
字段
callReportingEnabled

boolean

通过 Google 系统对来电事件进行重定向，以启用来电报告。
callConversionReportingEnabled

boolean

是否启用来电转化报告。
callConversionAction

string

可归因于来电转化的客户级来电转化操作。如果未设置，系统会使用默认转化操作。只有在 callConversionReportingEnabled 设为 true 时才会生效。

ConversionTrackingSetting

与 Google Ads 转化跟踪相关的一系列客户级设置。

JSON 表示法 
{
  "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。此 ID 在客户选择启用跨帐号转化跟踪时设置，并且会覆盖 conversionTrackingId。此字段只能通过 Google Ads 界面进行管理。此字段为只读字段。

RemarketingSetting

客户的再营销设置。

JSON 表示法 
{
  "googleGlobalSiteTag": string
}
字段
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_CLICK 的转化。
AVERAGE_DAILY_SPEND_TOO_HIGH 客户的平均每日支出过高。
ANALYSIS_NOT_COMPLETE Google Ads 后端尚未计算客户是否符合条件。请稍后回来查看。
OTHER 客户因其他原因而不符合条件。

CustomerAgreementSetting

客户的客户协议设置。

JSON 表示法 
{
  "acceptedLeadFormTerms": boolean
}
字段
acceptedLeadFormTerms

boolean

仅限输出。客户是否已接受潜在客户表单的服务条款。

LocalServicesSettings

本地生活服务客户的设置。

JSON 表示法 
{
  "granularLicenseStatuses": [
    {
      object (GranularLicenseStatus)
    }
  ],
  "granularInsuranceStatuses": [
    {
      object (GranularInsuranceStatus)
    }
  ]
}
字段
granularLicenseStatuses[]

object (GranularLicenseStatus)

仅限输出。地理位置垂直级许可状态的只读列表。
granularInsuranceStatuses[]

object (GranularInsuranceStatus)

仅限输出。地理位置行业级保险状态的只读列表。

GranularLicenseStatus

地理位置和行业级别的许可状态。

JSON 表示法 
{
  "geoCriterionId": string,
  "categoryId": string,
  "verificationStatus": enum (LocalServicesVerificationStatus)
}
字段
geoCriterionId

string (int64 format)

仅限输出。与状态相关联的地理位置定位条件 ID。可以是国家/地区或州/省级行政区级别，具体取决于相关要求和地理位置。如需了解详情，请访问 https://developers.google.com/google-ads/api/data/geotargets。
categoryId

string

仅限输出。与状态关联的服务类别。例如，xcat:service_area_business_plumber。有关详情，请参阅：https://developers.google.com/google-ads/api/data/codes-formats#local_services_ids
verificationStatus

enum (LocalServicesVerificationStatus)

仅限输出。按地理位置和行业划分的精细许可状态。

LocalServicesVerificationStatus

描述特定本地生活服务广告验证类别状态的枚举。

枚举
UNSPECIFIED 未指定。
UNKNOWN 验证状态未知。
NEEDS_REVIEW 验证已开始，但尚未结束。
FAILED 验证失败。
PASSED 验证已通过。
NOT_APPLICABLE 验证不适用。
NO_SUBMISSION 需要验证，但还未提交。
PARTIAL_SUBMISSION 并非所有必需的验证已提交。
PENDING_ESCALATION 验证需要由本地生活服务广告运营专家进行审核。

GranularInsuranceStatus

地理位置和行业级别的保险状态。

JSON 表示法 
{
  "geoCriterionId": string,
  "categoryId": string,
  "verificationStatus": enum (LocalServicesVerificationStatus)
}
字段
geoCriterionId

string (int64 format)

仅限输出。与状态相关联的地理位置定位条件 ID。可以是国家/地区或州/省级行政区级别，具体取决于相关要求和地理位置。如需了解详情，请访问 https://developers.google.com/google-ads/api/data/geotargets。
categoryId

string

仅限输出。与状态关联的服务类别。例如，xcat:service_area_business_plumber。有关详情，请参阅：https://developers.google.com/google-ads/api/data/codes-formats#local_services_ids
verificationStatus

enum (LocalServicesVerificationStatus)

仅限输出。按地理位置和行业划分的细化保险状态。