Customer

• JSON 表示法
• CallReportingSetting <ph type="x-smartling-placeholder">
  </ph>
  • JSON 表示法
• ConversionTrackingSetting <ph type="x-smartling-placeholder">
  </ph>
  • JSON 表示法
• RemarketingSetting <ph type="x-smartling-placeholder">
  </ph>
  • JSON 表示法
• CustomerPayPerConversionEligibilityFailureReason
• CustomerAgreementSetting <ph type="x-smartling-placeholder">
  </ph>
  • JSON 表示法
• LocalServicesSettings <ph type="x-smartling-placeholder">
  </ph>
  • JSON 表示法
• GranularLicenseStatus <ph type="x-smartling-placeholder">
  </ph>
  • JSON 表示法
• LocalServicesVerificationStatus
• GranularInsuranceStatus <ph type="x-smartling-placeholder">
  </ph>
  • JSON 表示法

客户。

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 仅限输出。客户是否拥有合作伙伴计划徽章。如果客户未与合作伙伴计划相关联，则此字段为 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 界面进行管理。此字段为只读字段。

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) 仅限输出。按地理位置和行业细分的保险状态。