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

パラメータからトラッキング URL を作成するための URL テンプレート。update オペレーションでのみ変更可能。
finalUrlSuffix

string

パラメータを最終ページ URL に追加するための URL テンプレート。update オペレーションでのみ変更可能。
autoTaggingEnabled

boolean

お客様の自動タグ設定が有効かどうか。update オペレーションでのみ変更可能。
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

出力専用。フィードベースの住所がアセットベースの住所に移行されている場合は 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 に設定されている場合にのみ有効です。

ConversionTrackingSetting

Google 広告のコンバージョン トラッキングに関連する、お客様全体の設定の集合。

JSON 表現 
{
  "acceptedCustomerDataTerms": boolean,
  "conversionTrackingStatus": enum (ConversionTrackingStatus),
  "enhancedConversionsForLeadsEnabled": boolean,
  "googleAdsConversionCustomer": string,
  "conversionTrackingId": string,
  "crossAccountConversionTrackingId": string
}
フィールド
acceptedCustomerDataTerms

boolean

出力専用。お客様が顧客データに関する規約に同意したかどうか。クロスアカウント コンバージョン トラッキングを使用している場合、この値は MCC から継承されます。このフィールドは読み取り専用です。詳しくは、https://support.google.com/adspolicy/answer/7475709 をご覧ください。
conversionTrackingStatus

enum (ConversionTrackingStatus)

出力専用。コンバージョン トラッキングのステータス。お客様がコンバージョン トラッキングを使用しているかどうか、およびこのお客様のコンバージョン トラッキングのオーナーが誰であるかを示します。このお客様がクロスアカウント コンバージョン トラッキングを使用している場合、返される値はリクエストの login-customer-id によって異なります。
enhancedConversionsForLeadsEnabled

boolean

出力専用。お客様がリードの拡張コンバージョンを有効にしているかどうか。クロスアカウント コンバージョン トラッキングを使用している場合、この値は MCC から継承されます。このフィールドは読み取り専用です。
googleAdsConversionCustomer

string

コンバージョンが作成、管理される顧客のリソース名。このフィールドは読み取り専用です。
conversionTrackingId

string (int64 format)

出力専用。このアカウントで使用されているコンバージョン トラッキング ID。この ID は、お客様がコンバージョン トラッキングを使用しているかどうかは示しません（conversionTrackingStatus は示します）。このフィールドは読み取り専用です。
crossAccountConversionTrackingId

string (int64 format)

出力専用。お客様のマネージャーのコンバージョン トラッキング ID。クロスアカウント コンバージョン トラッキングを有効にしている場合に設定され、conversionTrackingId をオーバーライドします。このフィールドは、Google 広告の管理画面でのみ管理できます。このフィールドは読み取り専用です。

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 お客様の 1 日の平均費用が高すぎる。
ANALYSIS_NOT_COMPLETE お客様の利用資格は、Google 広告のバックエンドでまだ計算されていません。後ほどもう一度ご確認ください。
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)

出力専用。地域と業種別の詳細な保険ステータス。