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)
  },
  "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)

仅供输出。本地生活服务客户的设置。
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。这是在客户选择启用跨帐号转化跟踪时设置的，并且会覆盖 conversionTrackingId。此字段只能通过 Google Ads 界面进行管理。此字段为只读字段。

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 代码。

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 客户因其他原因而不符合条件。

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)

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