- JSON 表示法
- CallReportingSetting
- ConversionTrackingSetting
- ConversionTrackingStatus
- RemarketingSetting
- CustomerPayPerConversionEligibilityFailureReason
- CustomerAgreementSetting
- LocalServicesSettings
- GranularLicenseStatus
- LocalServicesVerificationStatus
- GranularInsuranceStatus
客户。
JSON 表示法 |
---|
{ "resourceName": string, "callReportingSetting": { object ( |
字段 | |
---|---|
resourceName |
不可变。客户的资源名称。客户资源名称采用以下格式:
|
callReportingSetting |
客户的广告来电统计报告设置。只有在 |
conversionTrackingSetting |
仅供输出。客户的转化跟踪设置。 |
remarketingSetting |
仅供输出。客户的再营销设置。 |
payPerConversionEligibilityFailureReasons[] |
仅供输出。客户无法使用 PaymentMode.CONVERSIONS 的原因。如果列表为空,则表示客户符合条件。此字段为只读字段。 |
optimizationScoreWeight |
仅供输出。客户的优化得分权重。 优化得分权重可用于比较/汇总多个非经理客户的优化得分。某位经理账号的总体优化得分的计算方法是,对其所有 此字段为只读字段。 |
status |
仅供输出。客户的状态。 |
customerAgreementSetting |
仅供输出。客户的客户协议设置。 |
localServicesSettings |
仅供输出。本地生活服务客户的设置。 |
id |
仅供输出。客户的 ID。 |
descriptiveName |
(可选)客户的非唯一描述性名称。 |
currencyCode |
不可变。账号采用的币种。支持 ISO 4217 标准中的一部分货币代码。 |
timeZone |
不可变。客户的当地时区 ID。 |
trackingUrlTemplate |
用于根据参数构建跟踪网址的网址模板。只有在 |
finalUrlSuffix |
用于将参数附加到最终到达网址的网址模板。只有在 |
autoTaggingEnabled |
是否为客户启用了自动标记功能。 |
hasPartnersBadge |
仅供输出。客户是否拥有合作伙伴计划徽章。如果客户未参与合作伙伴计划,此 ID 为 false。如需了解详情,请参阅 https://support.google.com/partners/answer/3125774。 |
manager |
仅供输出。客户是否为经理。 |
testAccount |
仅供输出。客户使用的账号是否为测试账号。 |
optimizationScore |
仅供输出。客户的优化得分。 优化得分是一个估算的分值,反映了客户的广告系列在设置方面的优化程度。范围是 0% (0.0) 到 100% (1.0)。对于所有经理客户和未评分的非经理客户,此字段均为 null。 请参阅“优化得分简介”,网址为 https://support.google.com/google-ads/answer/9061546。 此字段为只读字段。 |
locationAssetAutoMigrationDone |
仅供输出。如果基于 Feed 的地理位置已迁移到基于素材资源的地理位置,则为 True。 |
imageAssetAutoMigrationDone |
仅供输出。如果基于 Feed 的图片已迁移到基于素材资源的图片,则为 true。 |
locationAssetAutoMigrationDoneDateTime |
仅供输出。从基于 Feed 的位置到资产基准位置的迁移时间戳,采用 yyyy-MM-dd HH:mm:ss 格式。 |
imageAssetAutoMigrationDoneDateTime |
仅供输出。从基于 Feed 的图片到素材资源基础图片的迁移时间戳(采用 yyyy-MM-dd HH:mm:ss 格式)。 |
CallReportingSetting
客户的广告来电统计报告设置。只有在 update
操作中才是可变的。
JSON 表示法 |
---|
{ "callReportingEnabled": boolean, "callConversionReportingEnabled": boolean, "callConversionAction": string } |
字段 | |
---|---|
callReportingEnabled |
通过 Google 系统对来电事件进行重定向,以启用来电报告。 |
callConversionReportingEnabled |
是否启用来电转化报告。 |
callConversionAction |
可归因于来电转化的客户级来电转化操作。如果未设置,系统会使用默认转化操作。仅当 callConversionReportingEnabled 设置为 true 时才会生效。 |
ConversionTrackingSetting
与 Google Ads 转化跟踪相关的一系列客户设置。
JSON 表示法 |
---|
{
"acceptedCustomerDataTerms": boolean,
"conversionTrackingStatus": enum ( |
字段 | |
---|---|
acceptedCustomerDataTerms |
仅供输出。客户是否已接受客户数据条款。如果您使用的是跨帐号转化跟踪,则系统会从经理帐号沿用此值。此字段是只读字段。有关详情,请参阅 https://support.google.com/adspolicy/answer/7475709。 |
conversionTrackingStatus |
仅供输出。转化跟踪状态。它可表明客户是否在使用转化跟踪,以及此客户的转化跟踪所有者是谁。如果此客户使用的是跨帐号转化跟踪,则返回的值会因请求的 |
enhancedConversionsForLeadsEnabled |
仅供输出。客户是否启用了增强型潜在客户转化。如果您使用的是跨帐号转化跟踪,则系统会从经理帐号沿用此值。此字段为只读字段。 |
googleAdsConversionCustomer |
仅供输出。在其中创建和管理转化的客户的资源名称。此字段为只读字段。 |
conversionTrackingId |
仅供输出。用于此账号的转化跟踪 ID。此 ID 无法指明客户是否在使用转化跟踪(conversionTrackingStatus 表示)。此字段为只读字段。 |
crossAccountConversionTrackingId |
仅供输出。客户的经理的转化跟踪 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 |
仅供输出。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 |
仅供输出。客户是否已接受潜在客户表单的服务条款。 |
LocalServicesSettings
本地生活服务客户的设置。
JSON 表示法 |
---|
{ "granularLicenseStatuses": [ { object ( |
字段 | |
---|---|
granularLicenseStatuses[] |
仅供输出。地理位置行业级许可状态的只读列表。 |
granularInsuranceStatuses[] |
仅供输出。地理位置行业级保险状态的只读列表。 |
GranularLicenseStatus
地理位置和行业级别的许可状态。
JSON 表示法 |
---|
{
"geoCriterionId": string,
"categoryId": string,
"verificationStatus": enum ( |
字段 | |
---|---|
geoCriterionId |
仅供输出。与状态相关联的地理位置定位条件 ID。可以是国家/地区或州/省级行政区一级,具体取决于相关要求和地理位置。如需了解详情,请参阅 https://developers.google.com/google-ads/api/data/geotargets。 |
categoryId |
仅供输出。与状态关联的服务类别。例如 xcat:service_area_business_plumber。有关详情,请参阅:https://developers.google.com/google-ads/api/data/codes-formats#local_services_ids |
verificationStatus |
仅供输出。按地理位置和行业细分许可状态。 |
LocalServicesVerificationStatus
用于描述特定本地生活服务广告验证类别的状态的枚举。
枚举 | |
---|---|
UNSPECIFIED |
未指定。 |
UNKNOWN |
验证状态未知。 |
NEEDS_REVIEW |
验证已开始,但尚未完成。 |
FAILED |
验证失败。 |
PASSED |
验证已通过。 |
NOT_APPLICABLE |
验证不适用。 |
NO_SUBMISSION |
需要进行验证,但尚待提交。 |
PARTIAL_SUBMISSION |
并非所有必需的验证都已提交。 |
PENDING_ESCALATION |
验证需要本地生活服务广告运营专家进行审核。 |
GranularInsuranceStatus
地理位置和行业级别的保险状态。
JSON 表示法 |
---|
{
"geoCriterionId": string,
"categoryId": string,
"verificationStatus": enum ( |
字段 | |
---|---|
geoCriterionId |
仅供输出。与状态相关联的地理位置定位条件 ID。可以是国家/地区或州/省级行政区一级,具体取决于相关要求和地理位置。如需了解详情,请参阅 https://developers.google.com/google-ads/api/data/geotargets。 |
categoryId |
仅供输出。与状态关联的服务类别。例如 xcat:service_area_business_plumber。有关详情,请参阅:https://developers.google.com/google-ads/api/data/codes-formats#local_services_ids |
verificationStatus |
仅供输出。按地理位置和行业细分的保险状态。 |