インデックス
AccessibleBiddingStrategy(メッセージ)AccessibleBiddingStrategy.MaximizeConversionValue(メッセージ)AccessibleBiddingStrategy.MaximizeConversions(メッセージ)AccessibleBiddingStrategy.TargetCpa(メッセージ)AccessibleBiddingStrategy.TargetImpressionShare(メッセージ)AccessibleBiddingStrategy.TargetRoas(メッセージ)AccessibleBiddingStrategy.TargetSpend(メッセージ)Ad(メッセージ)AdGroup(メッセージ)AdGroupAd(メッセージ)AdGroupAdEffectiveLabel(メッセージ)AdGroupAdLabel(メッセージ)AdGroupAsset(メッセージ)AdGroupAssetSet(メッセージ)AdGroupAudienceView(メッセージ)AdGroupBidModifier(メッセージ)AdGroupCriterion(メッセージ)AdGroupCriterion.PositionEstimates(メッセージ)AdGroupCriterion.QualityInfo(メッセージ)AdGroupCriterionEffectiveLabel(メッセージ)AdGroupCriterionLabel(メッセージ)AdGroupEffectiveLabel(メッセージ)AdGroupLabel(メッセージ)AgeRangeView(メッセージ)Asset(メッセージ)AssetGroup(メッセージ)AssetGroupAsset(メッセージ)AssetGroupAssetCombinationData(メッセージ)AssetGroupListingGroupFilter(メッセージ)AssetGroupSignal(メッセージ)AssetGroupTopCombinationView(メッセージ)AssetSet(メッセージ)AssetSetAsset(メッセージ)Audience(メッセージ)BiddingStrategy(メッセージ)Campaign(メッセージ)Campaign.DynamicSearchAdsSetting(メッセージ)Campaign.GeoTargetTypeSetting(メッセージ)Campaign.NetworkSettings(メッセージ)Campaign.OptimizationGoalSetting(メッセージ)Campaign.SelectiveOptimization(メッセージ)Campaign.ShoppingSetting(メッセージ)Campaign.TrackingSetting(メッセージ)CampaignAsset(メッセージ)CampaignAssetSet(メッセージ)CampaignAudienceView(メッセージ)CampaignBudget(メッセージ)CampaignCriterion(メッセージ)CampaignEffectiveLabel(メッセージ)CampaignLabel(メッセージ)CartDataSalesView(メッセージ)Conversion(メッセージ)ConversionAction(メッセージ)ConversionAction.AttributionModelSettings(メッセージ)ConversionAction.FloodlightSettings(メッセージ)ConversionAction.ValueSettings(メッセージ)ConversionCustomVariable(メッセージ)ConversionCustomVariable.FloodlightConversionCustomVariableInfo(メッセージ)ConversionTrackingSetting(メッセージ)CustomColumn(メッセージ)Customer(メッセージ)CustomerAsset(メッセージ)CustomerAssetSet(メッセージ)CustomerClient(メッセージ)CustomerManagerLink(メッセージ)DoubleClickCampaignManagerSetting(メッセージ)DynamicSearchAdsSearchTermView(メッセージ)GenderView(メッセージ)GeoTargetConstant(メッセージ)KeywordView(メッセージ)Label(メッセージ)LanguageConstant(メッセージ)ListingGroupFilterDimension(メッセージ)ListingGroupFilterDimension.ProductBiddingCategory(メッセージ)ListingGroupFilterDimension.ProductBrand(メッセージ)ListingGroupFilterDimension.ProductChannel(メッセージ)ListingGroupFilterDimension.ProductCondition(メッセージ)ListingGroupFilterDimension.ProductCustomAttribute(メッセージ)ListingGroupFilterDimension.ProductItemId(メッセージ)ListingGroupFilterDimension.ProductType(メッセージ)ListingGroupFilterDimensionPath(メッセージ)LocationView(メッセージ)ProductBiddingCategoryConstant(メッセージ)ProductGroupView(メッセージ)SearchAds360Field(メッセージ)ShoppingPerformanceView(メッセージ)UserList(メッセージ)UserLocationView(メッセージ)Visit(メッセージ)WebpageView(メッセージ)
AccessibleBiddingStrategy
お客様が所有し、お客様と共有している BiddingStrategies のビューを表します。
BiddingStrategy とは異なり、このリソースには、お客様が所有する戦略に加えて、お客様のマネージャーが所有し、お客様と共有している戦略も含まれます。このリソースは指標を提供しず、BiddingStrategy 属性の限定されたサブセットのみを公開します。
| フィールド | |
|---|---|
resource_name | 
                
                   
 アクセス可能な入札戦略のリソース名。AccessibleBiddingStrategy リソース名の形式は次のとおりです。 
  | 
              
id | 
                
                   
 入札戦略の ID。  | 
              
name | 
                
                   
 入札戦略の名前。  | 
              
type | 
                
                  
                   入札戦略のタイプ。  | 
              
owner_customer_id | 
                
                   
 入札戦略を所有するお客様の ID。  | 
              
owner_descriptive_name | 
                
                   
 入札戦略を所有するお客様の descriptive_name。  | 
              
共用体フィールド  設定できる値は 1 つだけです。  | 
              |
maximize_conversion_value | 
                
                  
                   予算を消化しながらキャンペーンのコンバージョン値を最大化できる自動入札戦略。  | 
              
maximize_conversions | 
                
                  
                   予算を消化しながら最大限のコンバージョン数が得られるよう、入札単価を自動的に調整する自動入札戦略です。  | 
              
target_cpa | 
                
                  
                   指定した目標コンバージョン単価でコンバージョンを最大限に獲得できるように入札単価が設定される入札戦略です。  | 
              
target_impression_share | 
                
                  
                   選択したインプレッション率を重視して自動的に最適化する入札戦略。  | 
              
target_roas | 
                
                  
                   特定の目標広告費用対効果(ROAS)の平均値を達成しながら収益を最大化できる入札戦略。  | 
              
target_spend | 
                
                  
                   予算内でクリック数を最大化できるように入札単価を設定する入札戦略。  | 
              
MaximizeConversionValue
予算を消化しながらキャンペーンのコンバージョン値を最大化できる自動入札戦略。
| フィールド | |
|---|---|
target_roas | 
                
                   
 目標広告費用対効果(LTV)オプション。設定した場合、入札戦略では目標広告費用対効果を平均化しながら、収益を最大化します。目標広告費用対効果が高い場合、入札戦略では予算全額を使用できない可能性があります。目標広告費用対効果が設定されていない場合、入札戦略では予算に対して可能な限り高い広告費用対効果を達成することを目指します。  | 
              
MaximizeConversions
予算を消化しながら最大限のコンバージョン数が得られるよう、入札単価を自動的に調整する自動入札戦略です。
| フィールド | |
|---|---|
target_cpa | 
                
                   
 目標コンバージョン単価(CPA)オプション。1 件の獲得につき支払う金額の平均です。  | 
              
target_cpa_micros | 
                
                   
 目標コンバージョン単価(CPA)オプション。1 件の獲得につき支払う金額の平均です。  | 
              
TargetCpa
指定した目標コンバージョン単価でコンバージョンを最大限に獲得できるように入札単価が調整される自動入札戦略です。
| フィールド | |
|---|---|
target_cpa_micros | 
                
                   
 平均 CPA の目標値。この目標は、アカウントの通貨に基づき、請求可能な最小単位以上である必要があります。  | 
              
TargetRoas
特定の目標広告費用対効果(ROAS)の平均値を達成しながら収益を最大化できる自動入札戦略。
| フィールド | |
|---|---|
target_roas | 
                
                   
 費用単価の選択された収益(コンバージョン データに基づく)。  | 
              
TargetSpend
予算内でクリック数を最大化できるように入札単価を自動的に調整する自動入札戦略です。
| フィールド | |
|---|---|
target_spend_micros | 
                
                   
 クリック数を最大化するための目標予算。目標予算の入札者は、この値と、自然なスロットリング予算額のうち、少ない方の金額を支出しようとします。指定しない場合、予算が目標予算として使用されます。このフィールドは非推奨のため使用不可です。詳しくは、https://ads-developers.googleblog.com/2020/05/reminder-about-sunset-creation-of.html をご覧ください。  | 
              
cpc_bid_ceiling_micros | 
                
                   
 入札戦略で設定可能な入札単価の上限。この制限は、この戦略で管理するすべてのキーワードに適用されます。  | 
              
広告
広告
| フィールド | |
|---|---|
resource_name | 
                
                   
 広告のリソース名。広告リソース名の形式は次のとおりです。 
  | 
              
final_urls[] | 
                
                   
 広告のすべてのクロスドメイン リダイレクトの後に可能性のある最終ページ URL のリスト。  | 
              
type | 
                
                  
                   広告タイプ。  | 
              
id | 
                
                   
 広告の ID です。  | 
              
display_url | 
                
                   
 一部の広告フォーマットの広告説明に表示される URL。  | 
              
name | 
                
                   
 広告の名前。広告を識別するためにのみ使用されます。一意である必要はなく、配信される広告には影響しません。name フィールドは現在、DisplayUploadAd、ImageAd、ShoppingComparisonListingAd、VideoAd でのみサポートされています。  | 
              
共用体フィールド ad_data。広告タイプに関連する詳細情報。必ず 1 つ設定する必要があります。ad_data は次のいずれかになります。 | 
              |
text_ad | 
                
                  
                   テキスト広告に関する詳細情報。  | 
              
expanded_text_ad | 
                
                   
 拡張テキスト広告に関する詳細情報。  | 
              
responsive_search_ad | 
                
                   
 レスポンシブ検索広告に関する詳細。  | 
              
product_ad | 
                
                  
                   商品広告に関する詳細情報。  | 
              
expanded_dynamic_search_ad | 
                
                   
 拡張動的検索広告に関する詳細。  | 
              
広告グループ
広告グループ。
| フィールド | |
|---|---|
resource_name | 
                
                   
 広告グループのリソース名。広告グループのリソース名の形式は次のとおりです。 
  | 
              
status | 
                
                  
                   広告グループのステータス。  | 
              
type | 
                
                  
                   広告グループのタイプ。  | 
              
ad_rotation_mode | 
                
                  
                   広告グループの広告のローテーション モード。  | 
              
creation_time | 
                
                   
 この広告グループが作成されたときのタイムスタンプ。このタイムスタンプは、顧客のタイムゾーンを「yyyy-MM-dd HH:mm:ss」形式で指定します。  | 
              
targeting_setting | 
                
                  
                   ターゲティング関連機能の設定。  | 
              
labels[] | 
                
                   
 この広告グループに適用されているラベルのリソース名。  | 
              
effective_labels[] | 
                
                   
 この広告グループに適用されている有効なラベルのリソース名。有効なラベルとは、この広告グループに継承または直接割り当てられているラベルです。  | 
              
engine_id | 
                
                   
 外部エンジン アカウントの広告グループの ID。このフィールドは、Google 広告アカウント以外のアカウントにのみ使用できます(Yahoo! Japan、Microsoft、Baidu など)。Google 広告エンティティの場合は、代わりに「ad_group.id」を使用します。  | 
              
start_date | 
                
                   
 この広告グループの広告配信を開始する日付。デフォルトでは、広告グループの開始日は、現在または開始日のいずれか遅い方になります。このフィールドを設定した場合、ユーザーのタイムゾーンで指定の日付の開始時間に広告グループが開始されます。このフィールドは、Microsoft Advertising アカウントと Facebook ゲートウェイ アカウントでのみ使用できます。 形式: YYYY-MM-DD 例: 2019-03-14  | 
              
end_date | 
                
                   
 広告グループの広告配信を終了する日付。デフォルトでは、広告グループは広告グループの終了日に終了します。このフィールドが設定されている場合、ユーザーのタイムゾーンで指定の日付に広告グループが終了します。このフィールドは、Microsoft Advertising アカウントと Facebook ゲートウェイ アカウントでのみ使用できます。 形式: YYYY-MM-DD 例: 2019-03-14  | 
              
language_code | 
                
                   
 広告グループ内の広告とキーワードの言語。このフィールドは、Microsoft Advertising アカウントでのみご利用いただけます。詳細: https://docs.microsoft.com/en-us/advertising/guides/ad-languages?view=bingads-13#adlanguage  | 
              
last_modified_time | 
                
                   
 この広告グループが最後に変更された日時。日時は、顧客のタイムゾーンの「yyyy-MM-dd HH:mm:ss.ssssss」形式です。  | 
              
id | 
                
                   
 広告グループの ID です。  | 
              
name | 
                
                   
 広告グループの名前です。 このフィールドは必須です。新しい広告グループを作成する場合は空にしないでください。 含めることができる文字は、UTF-8 の全角で 255 文字未満にする必要があります。 null(コードポイント 0x0)、NL ラインフィード(コードポイント 0xA)、改行(コードポイント 0xD)の文字を含めることはできません。  | 
              
cpc_bid_micros | 
                
                   
 最大 CPC(クリック単価)入札。  | 
              
engine_status | 
                
                  
                   広告グループのエンジン ステータス。  | 
              
AdGroupAd
広告グループの広告。
| フィールド | |
|---|---|
resource_name | 
                
                   
 広告のリソース名。広告グループ広告のリソース名の形式は次のとおりです。 
  | 
              
status | 
                
                  
                   広告のステータスです。  | 
              
ad | 
                
                  
                   広告。  | 
              
creation_time | 
                
                   
 この ad_group_ad が作成されたときのタイムスタンプ。日時は、顧客のタイムゾーンの「yyyy-MM-dd HH:mm:ss.ssssss」形式です。  | 
              
labels[] | 
                
                   
 この広告グループの広告に適用されているラベルのリソース名。  | 
              
effective_labels[] | 
                
                   
 この広告に適用されている有効なラベルのリソース名。有効なラベルとは、この広告に継承されているラベルまたは直接割り当てられているラベルです。  | 
              
engine_id | 
                
                   
 外部エンジン アカウントの広告の ID。このフィールドは検索広告 360 アカウント(Yahoo、Microsoft、Baidu など)専用です。検索広告 360 以外のエンティティの場合は、代わりに「ad_group_ad.ad.id」を使用します。  | 
              
engine_status | 
                
                  
                   外部エンジン アカウントの広告の追加ステータス。外部アカウントの種類によって、アクティブ、有効、確認待ちなどのステータスが表示されます。  | 
              
last_modified_time | 
                
                   
 この広告グループの広告が最後に変更された日時。日時は、顧客のタイムゾーンの「yyyy-MM-dd HH:mm:ss.ssssss」形式です。  | 
              
AdGroupAdEffectiveLabel
広告グループ広告と効果的なラベルの関係。有効なラベルとは、この広告グループ広告に継承または直接割り当てられているラベルです。
| フィールド | |
|---|---|
resource_name | 
                
                   
 広告グループ広告の有効ラベルのリソース名。広告グループ広告の有効ラベルのリソース名の形式は   | 
              
ad_group_ad | 
                
                   
 有効なラベルが添付されている広告グループ広告。  | 
              
label | 
                
                   
 広告グループ広告に割り当てられた有効なラベル。  | 
              
owner_customer_id | 
                
                   
 有効なラベルを所有するお客様の ID。  | 
              
AdGroupAdLabel
広告グループ広告とラベルの関係。
| フィールド | |
|---|---|
resource_name | 
                
                   
 広告グループ広告ラベルのリソース名です。広告グループ広告ラベルのリソース名の形式は   | 
              
ad_group_ad | 
                
                   
 ラベルが添付される広告グループ広告。  | 
              
label | 
                
                   
 広告グループ広告に割り当てられるラベル。  | 
              
owner_customer_id | 
                
                   
 ラベルを所有するお客様の ID。  | 
              
AdGroupAsset
広告グループとアセット間のリンク。
| フィールド | |
|---|---|
resource_name | 
                
                   
 広告グループ アセットのリソース名。AdGroupAsset リソース名の形式は次のとおりです。 
  | 
              
ad_group | 
                
                   
 必須。アセットがリンクされている広告グループ。  | 
              
asset | 
                
                   
 必須。広告グループにリンクされているアセットです。  | 
              
status | 
                
                  
                   広告グループのアセットのステータス。  | 
              
AdGroupAssetSet
AdGroupAssetSet は、広告グループとアセットセット間のリンクです。AdGroupAssetSet を作成すると、アセット セットが広告グループにリンクされます。
| フィールド | |
|---|---|
resource_name | 
                
                   
 広告グループのアセットセットのリソース名。広告グループのアセットセットのリソース名の形式は次のとおりです。 
  | 
              
ad_group | 
                
                   
 このアセットセットがリンクされている広告グループ。  | 
              
asset_set | 
                
                   
 広告グループにリンクされているアセットセットです。  | 
              
status | 
                
                  
                   広告グループのアセットセットのステータス。読み取り専用です。  | 
              
AdGroupAudienceView
広告グループのオーディエンス ビュー。ディスプレイ ネットワークと YouTube ネットワークの広告向けインタレスト カテゴリとリマーケティング リスト、検索広告向けリマーケティング リスト(RLSA)のパフォーマンス データが、オーディエンス単位で集計されています。
| フィールド | |
|---|---|
resource_name | 
                
                   
 広告グループのオーディエンス ビューのリソース名。広告グループ オーディエンス ビューのリソース名の形式は次のとおりです。 
  | 
              
AdGroupBidModifier
広告グループの入札単価調整比を表します。
| フィールド | |
|---|---|
resource_name | 
                
                   
 広告グループの入札単価調整比のリソース名。広告グループの入札単価調整比のリソース名の形式は次のとおりです。 
  | 
              
bid_modifier | 
                
                   
 条件が一致した場合の入札の修飾子。修飾子は 0.1 ~ 10.0 の範囲内にする必要があります。PreferredContent の範囲は 1.0~6.0 です。デバイスタイプをオプトアウトするには、0 を使用します。  | 
              
共用体フィールド  V5 以降の作成オペレーションで必須です。  | 
              |
device | 
                
                  
                   デバイス条件。  | 
              
AdGroupCriterion
広告グループの条件。ad_group_criterion レポートには、広告グループに明示的に追加された条件のみが返されます。
| フィールド | |
|---|---|
resource_name | 
                
                   
 広告グループの条件のリソース名。広告グループの条件のリソース名の形式は次のとおりです。 
  | 
              
creation_time | 
                
                   
 この広告グループの条件が作成された時点のタイムスタンプ。このタイムスタンプは、顧客のタイムゾーンを「yyyy-MM-dd HH:mm:ss」形式で指定します。  | 
              
status | 
                
                  
                   条件のステータス。 これは、クライアントが設定した広告グループの条件エンティティのステータスです。注: UI レポートには、条件を実行できるかどうかに影響する追加情報が含まれている場合があります。API では「削除済み」である条件でも、管理画面では有効と表示されることがあります。たとえば、除外していない限り、デフォルトですべての年齢層のユーザーにキャンペーンが表示されます。対象の年齢層は広告が表示されるため、UI には「有効」と表示されます。しかし、非除外条件が追加されていないため、AdGroupCriterion.status には「removed」と表示されます。  | 
              
quality_info | 
                
                  
                   条件の品質に関する情報。  | 
              
type | 
                
                  
                   条件のタイプ。  | 
              
labels[] | 
                
                   
 この広告グループの条件に適用されているラベルのリソース名。  | 
              
effective_labels[] | 
                
                   
 この広告グループの条件に適用されている有効なラベルのリソース名。有効なラベルとは、この広告グループ条件に継承または直接割り当てられているラベルです。  | 
              
position_estimates | 
                
                  
                   さまざまな位置での条件付き入札単価の予測。  | 
              
final_urls[] | 
                
                   
 広告のすべてのクロスドメイン リダイレクトの後に可能性のある最終ページ URL のリスト。  | 
              
engine_id | 
                
                   
 外部エンジン アカウントの広告グループの条件の ID。このフィールドは、Google 広告アカウント以外のアカウントにのみ使用できます(Yahoo! Japan、Microsoft、Baidu など)。Google 広告エンティティの場合は、代わりに「ad_group_criterion.criterion_id」を使用します。  | 
              
last_modified_time | 
                
                   
 この広告グループの条件が最後に変更された日時。日時は、顧客のタイムゾーンの「yyyy-MM-dd HH:mm:ss.ssssss」形式です。  | 
              
criterion_id | 
                
                   
 条件の ID。  | 
              
ad_group | 
                
                   
 条件が属する広告グループです。  | 
              
negative | 
                
                   
 条件をターゲットに設定するか( このフィールドは変更できません。評価基準を「ポジティブ」から「ネガティブ」に切り替えるには、削除してから再度追加します。  | 
              
bid_modifier | 
                
                   
 条件が一致した場合の入札の修飾子。修飾子は 0.1 ~ 10.0 の範囲内にする必要があります。対象とする条件タイプのほとんどで、修飾子がサポートされています。  | 
              
cpc_bid_micros | 
                
                   
 クリック単価(CPC)。  | 
              
effective_cpc_bid_micros | 
                
                   
 有効 CPC(クリック単価)入札。  | 
              
engine_status | 
                
                  
                   広告グループのエンジン ステータスの条件。  | 
              
final_url_suffix | 
                
                   
 パラメータを最終ページ URL に追加するための URL テンプレート。  | 
              
tracking_url_template | 
                
                   
 トラッキング URL を作成するための URL テンプレート。  | 
              
共用体フィールド  必ず 1 つ設定する必要があります。  | 
              |
keyword | 
                
                  
                   キーワード。  | 
              
listing_group | 
                
                  
                   リスティング グループ。  | 
              
age_range | 
                
                  
                   年齢層。  | 
              
gender | 
                
                  
                   性別。  | 
              
user_list | 
                
                  
                   ユーザーリスト。  | 
              
webpage | 
                
                  
                   ウェブアプリ  | 
              
location | 
                
                  
                   位置情報] をタップします。  | 
              
PositionEstimates
さまざまな位置での条件付き入札単価の予測。
| フィールド | |
|---|---|
top_of_page_cpc_micros | 
                
                   
 広告が検索結果の最初のページの上部に表示されるために必要なクリック単価の見積もり。  | 
              
QualityInfo
広告グループの条件の品質情報のコンテナ。
| フィールド | |
|---|---|
quality_score | 
                
                   
 品質スコア。 Google が値を決定するための十分な情報を持っていない場合は、このフィールドに値が入力されないことがあります。  | 
              
AdGroupCriterionEffectiveLabel
広告グループ条件と有効なラベルの関係。有効なラベルとは、この広告グループ条件に継承または直接割り当てられているラベルです。
| フィールド | |
|---|---|
resource_name | 
                
                   
 広告グループ条件の効果ラベルのリソース名。広告グループ条件の有効ラベルのリソース名の形式は   | 
              
ad_group_criterion | 
                
                   
 有効なラベルが添付されている広告グループ条件。  | 
              
label | 
                
                   
 広告グループ条件に割り当てられている有効なラベル。  | 
              
owner_customer_id | 
                
                   
 有効なラベルを所有するお客様の ID。  | 
              
AdGroupCriterionLabel
広告グループ条件とラベルの関係。
| フィールド | |
|---|---|
resource_name | 
                
                   
 広告グループ条件ラベルのリソース名。広告グループ条件ラベルのリソース名の形式は   | 
              
ad_group_criterion | 
                
                   
 ラベルが添付される広告グループ条件。  | 
              
label | 
                
                   
 広告グループ条件に割り当てられるラベル。  | 
              
owner_customer_id | 
                
                   
 ラベルを所有するお客様の ID。  | 
              
AdGroupEffectiveLabel
広告グループと有効なラベルの関係。有効なラベルとは、この広告グループに継承または直接割り当てられているラベルです。
| フィールド | |
|---|---|
resource_name | 
                
                   
 広告グループの効果ラベルのリソース名。広告グループ有効ラベルのリソース名の形式は   | 
              
ad_group | 
                
                   
 有効なラベルが添付されている広告グループ。  | 
              
label | 
                
                   
 広告グループに割り当てられている有効なラベル。  | 
              
owner_customer_id | 
                
                   
 有効なラベルを所有するお客様の ID。  | 
              
AdGroupLabel
広告グループとラベルの関係。
| フィールド | |
|---|---|
resource_name | 
                
                   
 広告グループラベルのリソース名です。広告グループ ラベルのリソース名の形式は   | 
              
ad_group | 
                
                   
 ラベルが添付される広告グループ。  | 
              
label | 
                
                   
 広告グループに割り当てられるラベル。  | 
              
owner_customer_id | 
                
                   
 ラベルを所有するお客様の ID。  | 
              
AgeRangeView
年齢層ビュー。
| フィールド | |
|---|---|
resource_name | 
                
                   
 年齢層ビューのリソース名。年齢層ビューのリソース名の形式は次のとおりです。 
  | 
              
アセット
アセットは広告の一部であり、複数の広告で共有できます。画像(ImageAsset)、動画(YoutubeVideoAsset)などです。アセットは不変であり、削除できません。アセットの配信を停止するには、そのアセットを使用しているエンティティからアセットを削除します。
| フィールド | |
|---|---|
resource_name | 
                
                   
 アセットのリソース名。アセット リソース名の形式は次のとおりです。 
  | 
              
type | 
                
                  
                   アセットのタイプ。  | 
              
final_urls[] | 
                
                   
 すべてのクロスドメイン リダイレクト後の最終ページ URL のリスト。  | 
              
status | 
                
                  
                   アセットのステータス。  | 
              
creation_time | 
                
                   
 この求人が作成されたときのタイムスタンプ。このタイムスタンプは、顧客のタイムゾーンを「yyyy-MM-dd HH:mm:ss」形式で指定します。  | 
              
last_modified_time | 
                
                   
 このアセットが最後に変更された日時。日時は、顧客のタイムゾーンの「yyyy-MM-dd HH:mm:ss.ssssss」形式です。  | 
              
id | 
                
                   
 アセットの ID です。  | 
              
name | 
                
                   
 アセットの名前(省略可)。  | 
              
tracking_url_template | 
                
                   
 トラッキング URL を作成するための URL テンプレート。  | 
              
engine_status | 
                
                  
                   アセットのエンジン ステータス。  | 
              
共用体フィールド asset_data。アセットの特定のタイプ。asset_data は次のいずれかになります。 | 
              |
youtube_video_asset | 
                
                  
                   YouTube 動画アセット。  | 
              
image_asset | 
                
                  
                   画像アセット。  | 
              
text_asset | 
                
                  
                   テキスト アセット。  | 
              
callout_asset | 
                
                  
                   統合されたコールアウト アセット。  | 
              
sitelink_asset | 
                
                  
                   統合されたサイトリンク アセット。  | 
              
page_feed_asset | 
                
                  
                   統合されたページフィード アセット。  | 
              
mobile_app_asset | 
                
                  
                   モバイルアプリ アセット。  | 
              
call_asset | 
                
                  
                   統合された電話番号アセット。  | 
              
call_to_action_asset | 
                
                  
                   行動を促すフレーズのアセット。  | 
              
location_asset | 
                
                  
                   統合された住所アセット。  | 
              
AssetGroup
アセット グループ。AssetGroupAsset は、アセットをアセット グループにリンクするために使用されます。AssetGroupSignal は、シグナルをアセット グループに関連付けるために使用されます。
| フィールド | |
|---|---|
resource_name | 
                
                   
 アセット グループのリソース名。アセット グループのリソース名の形式は次のとおりです。 
  | 
              
id | 
                
                   
 アセット グループの ID。  | 
              
campaign | 
                
                   
 このアセット グループが関連付けられているキャンペーン。アセット グループにリンクされているアセット。  | 
              
name | 
                
                   
 必須。アセット グループの名前。必須。長さは 1 ~ 128 文字にする必要があります。キャンペーン内で一意にする必要があります。  | 
              
final_urls[] | 
                
                   
 すべてのクロスドメイン リダイレクト後の最終ページ URL のリスト。P-MAX では、デフォルトで URL はオプトアウトしない限り拡張の対象となります。  | 
              
final_mobile_urls[] | 
                
                   
 すべてのクロスドメイン リダイレクト後の最終ページ URL のリスト。P-MAX では、デフォルトで URL はオプトアウトしない限り拡張の対象となります。  | 
              
status | 
                
                  
                   アセット グループのステータス。  | 
              
path1 | 
                
                   
 広告に表示される URL に表示されるテキストの最初の部分です。  | 
              
path2 | 
                
                   
 広告に表示される URL に表示されるテキストの 2 番目の部分です。このフィールドは、path1 が設定されている場合にのみ設定できます。  | 
              
ad_strength | 
                
                  
                   このアセット グループの広告の有効性全体。  | 
              
AssetGroupAsset
AssetGroupAsset は、アセットとアセット グループをつなぐリンクです。AssetGroupAsset を追加すると、アセットとアセット グループがリンクされます。
| フィールド | |
|---|---|
resource_name | 
                
                   
 アセット グループ アセットのリソース名。アセット グループのアセット リソース名の形式は次のとおりです。 
  | 
              
asset_group | 
                
                   
 このアセット グループのアセットがリンクしているアセット グループ。  | 
              
asset | 
                
                   
 このアセット グループのアセットがリンクしているアセット。  | 
              
field_type | 
                
                  
                   アセット グループ内のアセットのプレースメントの説明。例: HEADLINE、YOUTUBE_VIDEO など  | 
              
status | 
                
                  
                   アセットとアセット グループ間のリンクのステータス。  | 
              
AssetGroupAssetCombinationData
アセット グループのアセットの組み合わせデータ
| フィールド | |
|---|---|
asset_combination_served_assets[] | 
                
                  
                   配信されたアセット。  | 
              
AssetGroupListingGroupFilter
AssetGroupListingGroupFilter は、アセット グループ内のリスティング グループ フィルタ ツリーノードを表します。
| フィールド | |
|---|---|
resource_name | 
                
                   
 アセット グループのリスティング グループのフィルタのリソース名。アセット グループのリスティング グループのフィルタのリソース名の形式は次のとおりです。 
  | 
              
asset_group | 
                
                   
 このアセット グループのリスティング グループのフィルタが属するアセット グループ。  | 
              
id | 
                
                   
 ListingGroupFilter の ID。  | 
              
type | 
                
                  
                   リスティング グループのフィルタノードのタイプ。  | 
              
vertical | 
                
                  
                   現在のノードツリーが表す縦方向。同じツリー内のノードはすべて同じカテゴリに属している必要があります。  | 
              
case_value | 
                
                  
                   このリスティング グループが親を絞り込む際に使用するディメンション値。ルート グループでは未定義です。  | 
              
parent_listing_group_filter | 
                
                   
 親リスティング グループの細分化のリソース名。ルート リスティング グループ フィルタノードの場合は null。  | 
              
path | 
                
                   
 このリスティング グループ フィルタを定義するディメンションのパス。  | 
              
AssetGroupSignal
AssetGroupSignal は、アセット グループ内のシグナルを表します。シグナルが存在すると、コンバージョンに至る可能性の高いユーザーについて P-MAX キャンペーンに伝えることができます。P-MAX ではシグナルを使用して、検索、ディスプレイ、動画などのさまざまなネットワークにおけるコンバージョンを特定するため、新しい類似ユーザーまたは購買意向の強い新しいユーザーを探します。
| フィールド | |
|---|---|
resource_name | 
                
                   
 アセット グループ シグナルのリソース名。アセット グループ シグナルのリソース名の形式は次のとおりです。 
  | 
              
asset_group | 
                
                   
 このアセット グループ シグナルが属するアセット グループ。  | 
              
共用体フィールド signal。アセット グループのシグナル。signal は次のいずれかになります。 | 
              |
audience | 
                
                  
                   P-MAX キャンペーンで使用するオーディエンス シグナル。  | 
              
AssetGroupTopCombinationView
アセット グループのアセットのトップ組み合わせの使用状況を示すビュー。
| フィールド | |
|---|---|
resource_name | 
                
                   
 アセット グループのトップ コンビネーション ビューのリソース名。AssetGroup のトップ コンビネーション ビューのリソース名の形式は、「customers/{customer_id}/assetGroupTopCombinationViews/{asset_group_id}~{asset_combination_category}」です。  | 
              
asset_group_top_combinations[] | 
                
                   
 一緒に配信されたアセットの組み合わせのうち、上位の組み合わせ。  | 
              
AssetSet
アセットのコレクションを表すアセットセット。AssetSetAsset を使用して、アセットをアセットセットにリンクします。
| フィールド | |
|---|---|
id | 
                
                   
 アセットセットの ID。  | 
              
resource_name | 
                
                   
 アセットセットのリソース名。アセットセットのリソース名の形式は次のとおりです。 
  | 
              
AssetSetAsset
AssetSetAsset は、アセットとアセットセットをつなぐリンクです。AssetSetAsset を追加すると、アセットとアセットセットがリンクされます。
| フィールド | |
|---|---|
resource_name | 
                
                   
 アセットセット アセットのリソース名。アセットセットのアセット リソース名の形式は次のとおりです。 
  | 
              
asset_set | 
                
                   
 このアセットセットのアセットがリンクしているアセットセット。  | 
              
asset | 
                
                   
 このアセットセットのアセットがリンクしているアセット。  | 
              
status | 
                
                  
                   アセットセットのアセットのステータス。読み取り専用です。  | 
              
オーディエンス
オーディエンスは、さまざまな属性を組み合わせてオーディエンスを定義する効果的なターゲット設定です。詳しいユーザー属性やアフィニティなどを指定して、ターゲット ユーザーのセグメントを表すオーディエンスを作成します。
| フィールド | |
|---|---|
resource_name | 
                
                   
 オーディエンスのリソース名。オーディエンス名の形式は次のとおりです。 
  | 
              
id | 
                
                   
 オーディエンスの ID。  | 
              
name | 
                
                   
 必須。オーディエンスの名前。すべてのオーディエンスで一意である必要があります。長さは 1 ~ 255 にする必要があります。  | 
              
description | 
                
                   
 このオーディエンスの説明。  | 
              
BiddingStrategy
入札戦略。
| フィールド | |
|---|---|
resource_name | 
                
                   
 入札戦略のリソース名。入札戦略リソース名の形式は次のとおりです。 
  | 
              
status | 
                
                  
                   入札戦略のステータス。 このフィールドは読み取り専用です。  | 
              
type | 
                
                  
                   入札戦略のタイプ。入札スキームを設定して入札戦略を作成します。 このフィールドは読み取り専用です。  | 
              
currency_code | 
                
                   
 入札戦略で使用される通貨(ISO 4217 の 3 文字の通貨コード)。 マネージャー アカウントの入札戦略の場合、この通貨は作成時に設定できます。デフォルトでは、マネージャー アカウントの通貨が使用されます。サービング カスタマーの場合、このフィールドは設定できません。サービング カスタマーのすべての戦略では、サービング カスタマーの通貨が暗黙的に使用されます。いずれの場合も、effective_currency_code フィールドは戦略で使用されている通貨を返します。  | 
              
id | 
                
                   
 入札戦略の ID。  | 
              
name | 
                
                   
 入札戦略の名前。アカウント内のすべての入札戦略は、それぞれ別の名前にする必要があります。 この文字列の長さは UTF-8 バイトで 1~255 の値にする必要があります(切り詰められます)。  | 
              
effective_currency_code | 
                
                   
 入札戦略で使用される通貨(ISO 4217 の 3 文字の通貨コード)。 マネージャー クライアントの入札戦略の場合、これは広告主が戦略を作成する際に設定した通貨です。お客様へのサービス提供の場合、これはお客様の currency_code です。 入札戦略の指標は、この通貨でレポートされます。 このフィールドは読み取り専用です。  | 
              
campaign_count | 
                
                   
 この入札戦略に関連付けられたキャンペーンの数。 このフィールドは読み取り専用です。  | 
              
non_removed_campaign_count | 
                
                   
 この入札戦略に関連付けられている削除されていないキャンペーンの数。 このフィールドは読み取り専用です。  | 
              
共用体フィールド  設定できる値は 1 つだけです。  | 
              |
enhanced_cpc | 
                
                  
                   コンバージョンにつながる可能性が高いクリックに対して入札単価を引き上げ、可能性が低いクリックに対しては入札単価を引き下げる入札戦略。  | 
              
maximize_conversion_value | 
                
                  
                   予算を消化しながらキャンペーンのコンバージョン値を最大化できる自動入札戦略。  | 
              
maximize_conversions | 
                
                  
                   予算を消化しながら最大限のコンバージョン数が得られるよう、入札単価を自動的に調整する自動入札戦略です。  | 
              
target_cpa | 
                
                  
                   指定した目標コンバージョン単価でコンバージョンを最大限に獲得できるように入札単価が設定される入札戦略です。  | 
              
target_impression_share | 
                
                  
                   選択したインプレッション率を重視して自動的に最適化する入札戦略。  | 
              
target_outrank_share | 
                
                  
                   広告主が特定の競合他社を上回る必要があるオークションの目標割合に基づいて入札単価を設定する入札戦略。このフィールドのサポートは終了しています。このフィールドを使用して新しい入札戦略を作成したり、このフィールドを含む入札戦略をキャンペーンに適用したりすることはできません。このスキーマがすでに入力されている戦略へのミューテーションは許可されます。  | 
              
target_roas | 
                
                  
                   特定の目標広告費用対効果(ROAS)の平均値を達成しながら収益を最大化できる入札戦略。  | 
              
target_spend | 
                
                  
                   予算内でクリック数を最大化できるように入札単価を設定する入札戦略。  | 
              
キャンペーン
キャンペーン。
| フィールド | |
|---|---|
resource_name | 
                
                   
 キャンペーンのリソース名。キャンペーン リソース名の形式は次のとおりです。 
  | 
              
status | 
                
                  
                   キャンペーンのステータス。 新しいキャンペーンを追加すると、ステータスはデフォルトで [有効] になります。  | 
              
serving_status | 
                
                  
                   キャンペーンの広告配信ステータス。  | 
              
bidding_strategy_system_status | 
                
                  
                   キャンペーンの入札戦略のシステム ステータス。  | 
              
ad_serving_optimization_status | 
                
                  
                   キャンペーンの広告配信の最適化ステータス。  | 
              
advertising_channel_type | 
                
                  
                   キャンペーン内の広告のメインの配信ターゲット。ターゲティング オプションは  このフィールドは必須で、新しいキャンペーンを作成する場合は空にしないでください。 キャンペーンの作成時にのみ設定できます。キャンペーンを作成した後は変更できません。  | 
              
advertising_channel_sub_type | 
                
                  
                   
 キャンペーンの作成時にのみ設定できます。キャンペーンを作成した後は変更できません。  | 
              
url_custom_parameters[] | 
                
                  
                   
  | 
              
real_time_bidding_setting | 
                
                  
                   リアルタイム入札の設定。この機能は、Ad Exchange ネットワークをターゲットとするキャンペーンでのみご利用いただけます。  | 
              
network_settings | 
                
                  
                   キャンペーンのネットワーク設定。  | 
              
dynamic_search_ads_setting | 
                
                  
                   動的検索広告(DSA)を管理するための設定。  | 
              
shopping_setting | 
                
                  
                   ショッピング キャンペーンを管理するための設定。  | 
              
geo_target_type_setting | 
                
                  
                   広告の地理ターゲティングの設定。  | 
              
effective_labels[] | 
                
                   
 このキャンペーンに適用されている有効なラベルのリソース名。有効なラベルとは、このキャンペーンに継承または直接割り当てられているラベルです。  | 
              
labels[] | 
                
                   
 このキャンペーンに適用されたラベルのリソース名。  | 
              
bidding_strategy_type | 
                
                  
                   入札戦略のタイプ。 入札戦略を作成するには、標準入札戦略を作成する入札スキームを設定するか、ポートフォリオ入札戦略を作成する  このフィールドは読み取り専用です。  | 
              
accessible_bidding_strategy | 
                
                   
 AccessibleBiddingStrategy のリソース名。これは、接続されたポートフォリオ入札戦略の制限なしの属性の読み取り専用ビューで、「bidding_strategy」で識別されます。キャンペーンでポートフォリオ戦略を使用していない場合は空白です。制限なしの戦略属性は、戦略を共有しているすべてのお客様が使用でき、AccessibleBiddingStrategy リソースから読み取られます。一方、制限付き属性は、戦略のオーナー カスタマーとそのマネージャーのみが使用できます。制限付きの属性は、BiddingStrategy リソースからのみ読み取ることができます。  | 
              
frequency_caps[] | 
                
                  
                   各ユーザーにこのキャンペーンの広告を表示する回数を制限するリスト。  | 
              
selective_optimization | 
                
                  
                   このキャンペーンの選択的な最適化設定。このキャンペーンで最適化するコンバージョン アクションのセットが含まれます。この機能は、AdvertisingChannelType として MULTI_CHANNEL、AdvertisingChannelSubType として APP_CAMPAIGN または APP_CAMPAIGN_FOR_ENGAGEMENT を使用するアプリ キャンペーンにのみ適用されます。  | 
              
optimization_goal_setting | 
                
                  
                   このキャンペーンの最適化目標の設定。これには、一連の最適化目標タイプが含まれます。  | 
              
tracking_setting | 
                
                  
                   トラッキング情報のキャンペーン単位の設定。  | 
              
engine_id | 
                
                   
 外部エンジン アカウントのキャンペーンの ID。このフィールドは、Google 広告アカウント以外のアカウントにのみ使用できます(Yahoo! Japan、Microsoft、Baidu など)。Google 広告エンティティの場合は、代わりに「campaign.id」を使用します。  | 
              
excluded_parent_asset_field_types[] | 
                
                  
                   このキャンペーンから除外するアセット フィールドのタイプ。これらのフィールド タイプを持つアセットのリンクは、上位レベルからこのキャンペーンに継承されません。  | 
              
create_time | 
                
                   
 このキャンペーンが作成されたときのタイムスタンプ。このタイムスタンプは、顧客のタイムゾーンを「yyyy-MM-dd HH:mm:ss」形式で指定します。create_time は v1 で非推奨になります。代わりに creation_time を使用してください。  | 
              
creation_time | 
                
                   
 このキャンペーンが作成されたときのタイムスタンプ。このタイムスタンプは、顧客のタイムゾーンを「yyyy-MM-dd HH:mm:ss」形式で指定します。  | 
              
last_modified_time | 
                
                   
 このキャンペーンが最後に変更された日時。日時は、顧客のタイムゾーンの「yyyy-MM-dd HH:mm:ss.ssssss」形式です。  | 
              
id | 
                
                   
 キャンペーンの ID です。  | 
              
name | 
                
                   
 キャンペーンの名前です。 このフィールドは必須で、新しいキャンペーンを作成する場合は空にしないでください。 null(コードポイント 0x0)、NL ラインフィード(コードポイント 0xA)、改行(コードポイント 0xD)の文字を含めることはできません。  | 
              
tracking_url_template | 
                
                   
 トラッキング URL を作成するための URL テンプレート。  | 
              
campaign_budget | 
                
                   
 キャンペーンのキャンペーン予算のリソース名。  | 
              
start_date | 
                
                   
 お客様のタイムゾーンでキャンペーンが配信を開始した日付(YYYY-MM-DD 形式)。  | 
              
end_date | 
                
                   
 ユーザーのタイムゾーンで配信されるキャンペーンの最終日(YYYY-MM-DD 形式)。作成時にはデフォルトで 2037-12-30 に設定され、キャンペーンは無期限に実行されます。既存のキャンペーンを無期限で行うように設定するには、このフィールドを 2037-12-30 に設定します。  | 
              
final_url_suffix | 
                
                   
 パラレル トラッキングで配信されるランディング ページにクエリ パラメータを追加するために使用される接尾辞。  | 
              
url_expansion_opt_out | 
                
                   
 よりターゲティングされた URL への URL 拡張をオプトアウトすることを表します。オプトアウトした場合(true)、アセット グループ内の最終ページ URL または広告主様の Google Merchant Center またはビジネスデータ フィードで指定された URL のみがターゲティングされます。オプトインした場合(false)、ドメイン全体がターゲットになります。このフィールドは P-MAX キャンペーンでのみ設定できます。デフォルト値は false です。  | 
              
共用体フィールド  ポートフォリオ(BiddingStrategy サービスで作成)または標準(キャンペーンに埋め込まれている)のいずれかである必要があります。  | 
              |
bidding_strategy | 
                
                   
 キャンペーンで使用されるポートフォリオ入札戦略のリソース名。  | 
              
manual_cpa | 
                
                  
                   標準の「目標コンバージョン単価」個別入札戦略。広告主が指定したアクションごとに入札単価を設定できる個別単価設定の入札戦略。ローカル サービス キャンペーンでのみサポートされます。  | 
              
manual_cpc | 
                
                  
                   標準の個別クリック単価入札戦略。ユーザーがクリック単価で支払う、クリック単価の個別設定。  | 
              
manual_cpm | 
                
                  
                   標準の個別インプレッション単価入札戦略。インプレッション単価の個別設定。ユーザーは 1,000 インプレッションごとに支払います。  | 
              
maximize_conversions | 
                
                  
                   予算を消化しつつコンバージョン数を自動的に最大化する、標準のコンバージョン数の最大化入札戦略。  | 
              
maximize_conversion_value | 
                
                  
                   標準のコンバージョン値の最大化入札戦略では、予算を消化しつつ収益を最大化できるように入札単価が自動的に設定されます。  | 
              
target_cpa | 
                
                  
                   指定した目標コンバージョン単価でコンバージョンを最大限に獲得できるように入札単価が自動的に設定される標準の目標コンバージョン単価入札戦略です。  | 
              
target_impression_share | 
                
                  
                   目標インプレッション シェア入札戦略。選択したインプレッション率を達成するように入札単価を設定する自動入札戦略。  | 
              
target_roas | 
                
                  
                   特定の目標広告費用対効果(ROAS)の平均値を達成しながら、収益を自動的に最大化する標準の目標広告費用対効果入札戦略。  | 
              
target_spend | 
                
                  
                   予算内でクリック数を最大化できるように入札単価を自動的に調整する、標準の目標予算入札戦略です。  | 
              
percent_cpc | 
                
                  
                   商品やサービスの広告掲載価格の一部を入札単価とする、標準の割合クリック単価入札戦略。  | 
              
target_cpm | 
                
                  
                   1,000 インプレッションあたりの費用を自動的に最適化する入札戦略。  | 
              
DynamicSearchAdsSetting
動的検索広告(DSA)を管理するための設定。
| フィールド | |
|---|---|
domain_name | 
                
                   
 必須。この設定が表すインターネット ドメイン名(例: google.com、www.google.com)。  | 
              
language_code | 
                
                   
 必須。ドメインの言語を指定する言語コード(例: 「en」)。  | 
              
use_supplied_urls_only | 
                
                   
 キャンペーンで広告主様指定の URL のみを使用するかどうか。  | 
              
GeoTargetTypeSetting
広告の地理ターゲティングに関連する設定のコレクションを表します。
| フィールド | |
|---|---|
positive_geo_target_type | 
                
                  
                   この特定のキャンペーンでポジティブな地域ターゲティングに使用される設定。  | 
              
negative_geo_target_type | 
                
                  
                   この特定のキャンペーンで除外地域ターゲティングに使用されている設定。  | 
              
NetworkSettings
キャンペーンのネットワーク設定。
| フィールド | |
|---|---|
target_google_search | 
                
                   
 google.com の検索結果に広告を掲載するかどうか。  | 
              
target_search_network | 
                
                   
 Google 検索ネットワークのパートナー サイトに広告を配信するかどうか(  | 
              
target_content_network | 
                
                   
 Google ディスプレイ ネットワークの指定したプレースメントに広告を配信するかどうか。プレースメントは、プレースメント条件で指定します。  | 
              
target_partner_search_network | 
                
                   
 Google パートナー ネットワークで広告を配信するかどうか。この機能は、一部の Google パートナー アカウントでのみご利用いただけます。  | 
              
OptimizationGoalSetting
このキャンペーンの最適化目標の設定。これには、一連の最適化目標タイプが含まれます。
| フィールド | |
|---|---|
optimization_goal_types[] | 
                
                  
                   最適化目標の種類のリスト。  | 
              
SelectiveOptimization
このキャンペーンの選択的な最適化設定。このキャンペーンで最適化するコンバージョン アクションのセットが含まれます。この機能は、AdvertisingChannelType として MULTI_CHANNEL、AdvertisingChannelSubType として APP_CAMPAIGN または APP_CAMPAIGN_FOR_ENGAGEMENT を使用するアプリ キャンペーンにのみ適用されます。
| フィールド | |
|---|---|
conversion_actions[] | 
                
                   
 このキャンペーンの最適化に使用するコンバージョン アクションのリソース名のセット。  | 
              
ShoppingSetting
ショッピング キャンペーンの設定。キャンペーンで宣伝できる商品の範囲と、このキャンペーンと他のショッピング キャンペーンとの連携方法を定義します。
| フィールド | |
|---|---|
feed_label | 
                
                   
 キャンペーンに含める商品のフィードラベル。設定できるのは、feed_label または sales_country のいずれか 1 つだけです。sales_country の代わりに使用する場合、feed_label フィールドには同じ形式の国コード(例: 'XX')を使用できます。それ以外の場合は、Google Merchant Center でフィードラベルに使用されている任意の文字列にすることができます。  | 
              
use_vehicle_inventory | 
                
                   
 車両リスティングの広告枠をターゲットに設定するかどうか。  | 
              
merchant_id | 
                
                   
 Merchant Center アカウントの ID。このフィールドは作成オペレーションで必須です。このフィールドはショッピング キャンペーンでは変更できません。  | 
              
sales_country | 
                
                   
 キャンペーンに含める商品の販売国。  | 
              
campaign_priority | 
                
                   
 キャンペーンの優先度。優先度の数値が高いキャンペーンは、優先度の低いキャンペーンよりも優先されます。このフィールドはショッピング キャンペーンで必須です。値は 0 ~ 2 の範囲で指定できます。スマート ショッピング キャンペーンでは省略可能ですが、設定する場合は 3 に設定する必要があります。  | 
              
enable_local | 
                
                   
 ローカル商品を含めるかどうか。  | 
              
TrackingSetting
トラッキング情報のキャンペーン単位の設定。
| フィールド | |
|---|---|
tracking_url | 
                
                   
 動的トラッキングに使用される URL。  | 
              
CampaignAsset
キャンペーンとアセット間のリンク。
| フィールド | |
|---|---|
resource_name | 
                
                   
 キャンペーン アセットのリソース名。CampaignAsset リソース名の形式は次のとおりです。 
  | 
              
status | 
                
                  
                   キャンペーン アセットのステータス。  | 
              
campaign | 
                
                   
 アセットがリンクされているキャンペーン。  | 
              
asset | 
                
                   
 キャンペーンにリンクされているアセット。  | 
              
CampaignAssetSet
CampaignAssetSet は、キャンペーンとアセットセットをリンクするものです。CampaignAssetSet を追加すると、アセットセットがキャンペーンにリンクされます。
| フィールド | |
|---|---|
resource_name | 
                
                   
 キャンペーン アセットセットのリソース名。アセットセットのアセット リソース名の形式は次のとおりです。 
  | 
              
campaign | 
                
                   
 このアセットセットがリンクされているキャンペーン。  | 
              
asset_set | 
                
                   
 キャンペーンにリンクされているアセットセット。  | 
              
status | 
                
                  
                   キャンペーン アセットセット アセットのステータス。読み取り専用です。  | 
              
CampaignAudienceView
キャンペーンのオーディエンス ビュー。ディスプレイ ネットワークと YouTube ネットワークの広告向けインタレスト カテゴリとリマーケティング リスト、検索広告向けリマーケティング リスト(RLSA)のパフォーマンス データが、キャンペーンとオーディエンス条件別に集計されます。このビューには、キャンペーン単位で適用されているオーディエンスのみが表示されます。
| フィールド | |
|---|---|
resource_name | 
                
                   
 キャンペーン オーディエンス ビューのリソース名。キャンペーン オーディエンス ビューのリソース名の形式は次のとおりです。 
  | 
              
CampaignBudget
キャンペーンの予算。
| フィールド | |
|---|---|
resource_name | 
                
                   
 キャンペーン予算のリソース名。キャンペーン 予算のリソース名の形式は次のとおりです。 
  | 
              
delivery_method | 
                
                  
                   キャンペーン予算が消費される割合を決定する配信方法。 作成オペレーションで指定しない場合のデフォルトは STANDARD です。  | 
              
period | 
                
                  
                   予算を消化する期間です。指定しない場合のデフォルトは DAILY です。  | 
              
amount_micros | 
                
                   
 アカウントに対する現地通貨での予算額。金額はマイクロ秒単位で指定します。ここで、100 万が 1 通貨単位に相当します。1 か月の費用の上限はこの金額の 30.4 倍です。  | 
              
CampaignCriterion
キャンペーン条件。
| フィールド | |
|---|---|
resource_name | 
                
                   
 キャンペーン条件のリソース名。キャンペーン条件のリソース名の形式は次のとおりです。 
  | 
              
display_name | 
                
                   
 条件の表示名。 このフィールドはミューテーションの場合は無視されます。  | 
              
type | 
                
                  
                   条件のタイプ。  | 
              
status | 
                
                  
                   条件のステータス。  | 
              
last_modified_time | 
                
                   
 このキャンペーン条件が最後に変更された日時。日時は、顧客のタイムゾーンの「yyyy-MM-dd HH:mm:ss.ssssss」形式です。  | 
              
criterion_id | 
                
                   
 条件の ID。 このフィールドはミューテーション中は無視されます。  | 
              
bid_modifier | 
                
                   
 条件が一致した場合の入札の修飾子。修飾子は 0.1 ~ 10.0 の範囲内にする必要があります。対象とする条件タイプのほとんどで、修飾子がサポートされています。デバイスタイプをオプトアウトするには、0 を使用します。  | 
              
negative | 
                
                   
 条件をターゲットに設定するか(  | 
              
共用体フィールド  必ず 1 つ設定する必要があります。  | 
              |
keyword | 
                
                  
                   キーワード。  | 
              
location | 
                
                  
                   位置情報] をタップします。  | 
              
device | 
                
                  
                   デバイス] など)を選択します。  | 
              
age_range | 
                
                  
                   年齢層。  | 
              
gender | 
                
                  
                   性別。  | 
              
user_list | 
                
                  
                   ユーザーリスト。  | 
              
language | 
                
                  
                   学びました。  | 
              
webpage | 
                
                  
                   ウェブページ。  | 
              
location_group | 
                
                  
                   地域グループ  | 
              
CampaignEffectiveLabel
キャンペーンと有効なラベルの関係を表します。有効なラベルとは、このキャンペーンに継承または直接割り当てられているラベルです。
| フィールド | |
|---|---|
resource_name | 
                
                   
 リソースの名前。CampaignEffectivelabel リソース名の形式は   | 
              
campaign | 
                
                   
 有効なラベルが添付されているキャンペーン。  | 
              
label | 
                
                   
 キャンペーンに割り当てられている有効なラベル。  | 
              
owner_customer_id | 
                
                   
 有効なラベルを所有するお客様の ID。  | 
              
CampaignLabel
キャンペーンとラベルの関係を表します。
| フィールド | |
|---|---|
resource_name | 
                
                   
 リソースの名前。キャンペーン ラベルのリソース名の形式は   | 
              
campaign | 
                
                   
 ラベルが添付されるキャンペーン。  | 
              
label | 
                
                   
 キャンペーンに割り当てられるラベル。  | 
              
owner_customer_id | 
                
                   
 ラベルを所有するお客様の ID。  | 
              
CartDataSalesView
カートデータの販売ビュー。
| フィールド | |
|---|---|
resource_name | 
                
                   
 カートデータ販売ビューのリソース名。カートデータ販売ビューのリソース名の形式は   | 
              
コンバージョン
コンバージョン。
| フィールド | |
|---|---|
resource_name | 
                
                   
 コンバージョンのリソース名。コンバージョン リソース名の形式は次のとおりです。 
  | 
              
id | 
                
                   
 コンバージョンの ID  | 
              
criterion_id | 
                
                   
 検索広告 360 の条件 ID。値 0 は、その条件が関連付けられていないことを示します。  | 
              
merchant_id | 
                
                   
 クリックされた商品を含む検索広告 360 在庫アカウント ID。検索広告 360 内で在庫アカウントをリンクすると、検索広告 360 でこの ID が生成されます。  | 
              
ad_id | 
                
                   
 広告 ID。値 0 は、広告が関連付けられていないことを示します。  | 
              
click_id | 
                
                   
 コンバージョンが関連付けられている訪問の一意の文字列で、click id という URL パラメータとしてランディング ページに渡されます。  | 
              
visit_id | 
                
                   
 コンバージョンが関連付けられた検索広告 360 の訪問 ID。  | 
              
advertiser_conversion_id | 
                
                   
 オフライン コンバージョンの場合は、広告主が提供する ID です。このような ID が広告主から指定されていない場合、検索広告 360 によって生成されます。オンライン コンバージョンの場合は、広告主の Floodlight 処理に応じて、id 列または floodlight_order_id 列と同じになります。  | 
              
product_id | 
                
                   
 クリックされた商品の ID。  | 
              
product_channel | 
                
                  
                   クリックされた商品の販売チャネル: オンラインまたはローカル。  | 
              
product_language_code | 
                
                   
 商品に関するデータを含む Merchant Center フィードに設定されている言語(ISO-639-1)。  | 
              
product_store_id | 
                
                   
 クリックされたローカル在庫広告のストア。この ID はローカル商品フィードで使用されているストア ID と一致する必要があります。  | 
              
product_country_code | 
                
                   
 クリックされた商品を含む在庫フィードに登録されている国(ISO-3166 形式)。  | 
              
attribution_type | 
                
                  
                   コンバージョンが関連付けられた要素: 「訪問」または「キーワード + 広告」。  | 
              
conversion_date_time | 
                
                   
 コンバージョン イベントのタイムスタンプ。  | 
              
conversion_last_modified_date_time | 
                
                   
 コンバージョンが最後に変更された時刻のタイムスタンプ。  | 
              
conversion_visit_date_time | 
                
                   
 コンバージョンが関連付けられた訪問のタイムスタンプ。  | 
              
conversion_quantity | 
                
                   
 コンバージョンで記録されたアイテムの数量で、qty という URL パラメータによって特定されます。広告主がパラメータ(コンバージョンで販売されたアイテム数など)を動的に入力する必要がありますが、入力しない場合、デフォルトで 1 になります。  | 
              
conversion_revenue_micros | 
                
                   
 コンバージョン イベントの調整された収益(マイクロ秒単位)。これは常に広告配信中アカウントの通貨で表示されます。  | 
              
floodlight_original_revenue | 
                
                   
 Floodlight 通貨指示の変更前の、Floodlight イベントに関連付けられた、変更されていない元の収益(現在のレポートの通貨)。  | 
              
floodlight_order_id | 
                
                   
 コンバージョンに関して広告主から提供された Floodlight オーダー ID。  | 
              
status | 
                
                  
                   コンバージョンのステータス(ENABLED または REMOVED)。  | 
              
asset_id | 
                
                   
 コンバージョン イベント中に操作されたアセットの ID。  | 
              
asset_field_type | 
                
                  
                   コンバージョン イベントのアセット フィールド タイプ。  | 
              
ConversionAction
コンバージョン アクション。
| フィールド | |
|---|---|
resource_name | 
                
                   
 コンバージョン アクションのリソース名。コンバージョン アクションのリソース名の形式は次のとおりです。 
  | 
              
creation_time | 
                
                   
 Floodlight アクティビティの作成時点のタイムスタンプ(ISO 8601 形式)。  | 
              
status | 
                
                  
                   コンバージョン イベントの発生に関するこのコンバージョン アクションのステータス。  | 
              
type | 
                
                  
                   このコンバージョン アクションのタイプ。  | 
              
category | 
                
                  
                   このコンバージョン アクションで報告されたコンバージョンのカテゴリ。  | 
              
value_settings | 
                
                  
                   このコンバージョン アクションに関連付けられたコンバージョン イベントの値に関連する設定。  | 
              
attribution_model_settings | 
                
                  
                   このコンバージョン アクションのアトリビューション モデルに関連する設定。  | 
              
floodlight_settings | 
                
                  
                   Floodlight コンバージョン タイプの Floodlight 設定。  | 
              
id | 
                
                   
 コンバージョン アクションの ID  | 
              
name | 
                
                   
 コンバージョン アクションの名前。 新しいコンバージョン アクションを作成する場合は、このフィールドは必須です。空にすることはできません。  | 
              
primary_for_goal | 
                
                   
 コンバージョン アクションの primary_for_goal ビットが false の場合、そのコンバージョン アクションは、顧客のコンバージョン目標やキャンペーンのコンバージョン目標に関係なく、すべてのキャンペーンで入札対象外になります。ただし、カスタム目標では primary_for_goal が考慮されないため、キャンペーンに primary_for_goal = false のコンバージョン アクションで設定されたカスタム目標があっても、そのコンバージョン アクションは入札対象になります。デフォルトでは、primary_for_goal は設定されていない場合 true になります。V9 では、primary_for_goal は省略可能として宣言されていないため、作成後に「update」オペレーションで false に設定できます。  | 
              
owner_customer | 
                
                   
 コンバージョン アクションの所有者のお客様のリソース名。システム定義のコンバージョン アクションの場合は null です。  | 
              
include_in_client_account_conversions_metric | 
                
                   
 このコンバージョン アクションを「client_account_conversions」指標に含めるかどうか。  | 
              
include_in_conversions_metric | 
                
                   
 このコンバージョン アクションを [コンバージョン] 指標に含めるかどうか。  | 
              
click_through_lookback_window_days | 
                
                   
 インタラクション(クリックなど)からコンバージョン イベントまでの最大日数。  | 
              
app_id | 
                
                   
 アプリ コンバージョン アクションのアプリ ID。  | 
              
AttributionModelSettings
このコンバージョン アクションのアトリビューション モデルに関連する設定。
| フィールド | |
|---|---|
attribution_model | 
                
                  
                   このコンバージョン アクションのアトリビューション モデルのタイプ。  | 
              
data_driven_model_status | 
                
                  
                   コンバージョン アクションのデータドリブン アトリビューション モデルのステータス。  | 
              
FloodlightSettings
Floodlight コンバージョン アクションに関連する設定。
| フィールド | |
|---|---|
activity_group_tag | 
                
                   
 コンバージョンのレポート時に Floodlight アクティビティ グループの識別に使用される文字列。  | 
              
activity_tag | 
                
                   
 コンバージョンのレポート時に Floodlight アクティビティを識別するために使用される文字列。  | 
              
activity_id | 
                
                   
 DoubleClick Campaign Manager(DCM)の Floodlight アクティビティの ID。  | 
              
ValueSettings
このコンバージョン アクションに関連付けられたコンバージョン イベントの値に関連する設定。
| フィールド | |
|---|---|
default_value | 
                
                   
 このコンバージョン アクションのコンバージョン イベントが、無効な値、許可されていない値、または値なしで送信された場合、またはこのコンバージョン アクションが常にデフォルト値を使用するように設定されている場合に使用する値。  | 
              
default_currency_code | 
                
                   
 このコンバージョン アクションのコンバージョン イベントが、無効な通貨コードまたは通貨コードなしで送信された場合、またはこのコンバージョン アクションが常にデフォルト値を使用するように設定されている場合に使用する通貨コード。  | 
              
always_use_default_value | 
                
                   
 このコンバージョン アクションのコンバージョン イベントで指定された値と通貨コードの代わりに、デフォルト値とデフォルトの通貨コードを使用するかどうかを制御します。  | 
              
ConversionCustomVariable
コンバージョン カスタム変数。https://support.google.com/sa360/answer/13567857 の「検索広告 360 リニューアル版のカスタム Floodlight 指標およびディメンションについて」をご覧ください。
| フィールド | |
|---|---|
resource_name | 
                
                   
 コンバージョン カスタム変数のリソース名。コンバージョン カスタム変数のリソース名の形式は次のとおりです。 
  | 
              
id | 
                
                   
 コンバージョン カスタム変数の ID。  | 
              
name | 
                
                   
 必須。コンバージョン カスタム変数の名前。名前は一意である必要があります。名前の最大長は 100 文字です。前後に余分なスペースを入れないでください。  | 
              
tag | 
                
                   
 必須。コンバージョン カスタム変数のタグ。タグは一意で、先頭に「u」文字を配置し、その後に 100 未満の数字を続けて指定します。例: 「u4」。  | 
              
status | 
                
                   
 コンバージョン イベントの発生に関するコンバージョン カスタム変数のステータス。  | 
              
owner_customer | 
                
                   
 コンバージョン カスタム変数を所有する顧客のリソース名。  | 
              
family | 
                
                   
 コンバージョン カスタム変数のファミリー。  | 
              
cardinality | 
                
                   
 コンバージョン カスタム変数の基数。  | 
              
floodlight_conversion_custom_variable_info | 
                
                   
 検索広告 360 の Floodlight コンバージョン カスタム変数のフィールド。  | 
              
custom_column_ids[] | 
                
                   
 このコンバージョン カスタム変数を使用するカスタム列の ID。  | 
              
FloodlightConversionCustomVariableInfo
検索広告 360 の Floodlight コンバージョン カスタム変数に関する情報。
| フィールド | |
|---|---|
floodlight_variable_type | 
                
                  
                   検索広告 360 で定義された Floodlight 変数のタイプ。  | 
              
floodlight_variable_data_type | 
                
                  
                   検索広告 360 で定義された Floodlight 変数のデータタイプ。  | 
              
ConversionTrackingSetting
検索広告 360 コンバージョン トラッキングに関連する、クライアント全体の設定の集合。
| フィールド | |
|---|---|
accepted_customer_data_terms | 
                
                   
 お客様が顧客データに関する規約に同意したかどうか。クロスアカウント コンバージョン トラッキングを使用している場合、この値は MCC から継承されます。このフィールドは読み取り専用です。詳しくは、https://support.google.com/adspolicy/answer/7475709 をご覧ください。  | 
              
conversion_tracking_status | 
                
                  
                   コンバージョン トラッキングのステータス。お客様がコンバージョン トラッキングを使用しているかどうか、およびこのお客様のコンバージョン トラッキングのオーナーが誰であるかを示します。このお客様がクロスアカウント コンバージョン トラッキングを使用している場合、返される値はリクエストの   | 
              
enhanced_conversions_for_leads_enabled | 
                
                   
 お客様がリードの拡張コンバージョンを有効にしているかどうか。クロスアカウント コンバージョン トラッキングを使用している場合、この値は MCC から継承されます。このフィールドは読み取り専用です。  | 
              
google_ads_conversion_customer | 
                
                   
 コンバージョンの作成と管理を行う顧客のリソース名。このフィールドは読み取り専用です。  | 
              
conversion_tracking_id | 
                
                   
 このアカウントで使用されているコンバージョン トラッキング ID。この ID は、お客様がコンバージョン トラッキングを使用しているかどうかを示しません(conversion_tracking_status が示します)。このフィールドは読み取り専用です。  | 
              
google_ads_cross_account_conversion_tracking_id | 
                
                   
 お客様のマネージャーのコンバージョン トラッキング ID。これは、ユーザーがコンバージョン トラッキングを有効にしたときに設定され、conversion_tracking_id をオーバーライドします。このフィールドは、Google 広告の管理画面でのみ管理できます。このフィールドは読み取り専用です。  | 
              
cross_account_conversion_tracking_id | 
                
                   
 お客様のマネージャーのコンバージョン トラッキング ID。クロスアカウント コンバージョン トラッキングを有効にしている場合に設定され、conversion_tracking_id をオーバーライドします。  | 
              
CustomColumn
カスタム列。検索広告 360 のカスタム列については、https://support.google.com/sa360/answer/9633916 をご覧ください。
| フィールド | |
|---|---|
resource_name | 
                
                   
 カスタム列のリソース名。カスタム列のリソース名の形式は次のとおりです。 
  | 
              
id | 
                
                   
 カスタム列の ID。  | 
              
name | 
                
                   
 カスタム列のユーザー定義名。  | 
              
description | 
                
                   
 カスタム列のユーザー定義の説明。  | 
              
value_type | 
                
                  
                   カスタム列の結果値の型。  | 
              
references_attributes | 
                
                   
 カスタム列が 1 つ以上の属性を参照している場合、true。  | 
              
references_metrics | 
                
                   
 カスタム列が 1 つ以上の指標を参照している場合、true です。  | 
              
queryable | 
                
                   
 カスタム列が SearchAds360Service.Search と SearchAds360Service.SearchStream のクエリで使用できる場合、true。  | 
              
referenced_system_columns[] | 
                
                   
 このカスタム列で参照されているシステム列のリスト。たとえば、カスタム列「表示回数とクリック数の合計」は、システム列 {"metrics.clicks", "metrics.impressions"} を参照しています。  | 
              
render_type | 
                
                  
                   カスタム列の結果値の解釈方法。  | 
              
お客様
お客様。
| フィールド | |
|---|---|
resource_name | 
                
                   
 顧客のリソース名。顧客リソース名の形式は次のとおりです。 
  | 
              
conversion_tracking_setting | 
                
                  
                   お客様のコンバージョン トラッキング設定。  | 
              
account_type | 
                
                  
                   エンジン アカウント タイプ(Google 広告、Microsoft Advertising、Yahoo! JAPAN、Baidu、Facebook、エンジン トラッキングなど)  | 
              
double_click_campaign_manager_setting | 
                
                   
 マネージャーのお客様の DoubleClick Campaign Manager(DCM)の設定。  | 
              
account_status | 
                
                  
                   アカウントのステータス(有効、一時停止、削除など)。  | 
              
last_modified_time | 
                
                   
 この顧客が最後に変更された日時。日時は、顧客のタイムゾーンの「yyyy-MM-dd HH:mm:ss.ssssss」形式です。  | 
              
engine_id | 
                
                   
 外部エンジン アカウントのアカウント ID。  | 
              
status | 
                
                  
                   顧客のステータス。  | 
              
creation_time | 
                
                   
 この顧客が作成されたときのタイムスタンプ。このタイムスタンプは、顧客のタイムゾーンを「yyyy-MM-dd HH:mm:ss」形式で指定します。  | 
              
manager_id | 
                
                   
 管理者のお客様 ID。値 0 は、お客様に検索広告 360 マネージャーがいないことを意味します。  | 
              
manager_descriptive_name | 
                
                   
 マネージャーのわかりやすい名前。  | 
              
sub_manager_id | 
                
                   
 サブマネージャーのお客様 ID。値が 0 の場合、お客様にサブの検索広告 360 マネージャーがいないことを意味します。  | 
              
sub_manager_descriptive_name | 
                
                   
 サブマネージャーのわかりやすい名前。  | 
              
associate_manager_id | 
                
                   
 アソシエイト マネージャーのお客様 ID。値が 0 の場合、お客様に検索広告 360 アソシエイト マネージャーが割り当てられていないことを示します。  | 
              
associate_manager_descriptive_name | 
                
                   
 アソシエイト マネージャーのわかりやすい名前。  | 
              
account_level | 
                
                  
                   お客様のアカウント レベル: マネージャー、サブマネージャー、アソシエイト マネージャー、サービス アカウント。  | 
              
id | 
                
                   
 顧客の ID。  | 
              
descriptive_name | 
                
                   
 顧客の一意でないわかりやすい名前(省略可)。  | 
              
currency_code | 
                
                   
 アカウントが運用されている通貨。ISO 4217 標準の通貨コードのサブセットがサポートされています。  | 
              
time_zone | 
                
                   
 顧客のローカル タイムゾーン ID。  | 
              
tracking_url_template | 
                
                   
 パラメータからトラッキング URL を作成するための URL テンプレート。  | 
              
final_url_suffix | 
                
                   
 パラメータを最終ページ URL に追加するための URL テンプレート。  | 
              
auto_tagging_enabled | 
                
                   
 お客様の自動タグ設定が有効かどうか。  | 
              
manager | 
                
                   
 お客様がマネージャーであるかどうか。  | 
              
CustomerAsset
顧客とアセット間のリンク。
| フィールド | |
|---|---|
resource_name | 
                
                   
 顧客アセットのリソース名。CustomerAsset リソース名の形式は次のとおりです。 
  | 
              
asset | 
                
                   
 必須。顧客に関連付けられているアセット。  | 
              
status | 
                
                  
                   お客様のアセットのステータス。  | 
              
CustomerAssetSet
CustomerAssetSet は、顧客とアセットセット間のリンクです。CustomerAssetSet を追加すると、アセットセットが顧客にリンクされます。
| フィールド | |
|---|---|
resource_name | 
                
                   
 カスタマー アセットセットのリソース名。アセットセットのアセット リソース名の形式は次のとおりです。 
  | 
              
asset_set | 
                
                   
 顧客に関連付けられているアセットセット。  | 
              
customer | 
                
                   
 このアセットセットがリンクされている顧客。  | 
              
status | 
                
                  
                   顧客アセットセットのアセットのステータス。読み取り専用です。  | 
              
CustomerClient
特定のお客様とクライアント カスタマー間のリンク。CustomerClient は、マネージャー ユーザーにのみ存在します。直接および間接のすべてのクライアント カスタマーと、マネージャー自体が含まれます。
| フィールド | |
|---|---|
resource_name | 
                
                   
 お客様のクライアントのリソース名。CustomerClient リソース名の形式は   | 
              
applied_labels[] | 
                
                   
 リクエスト元のお客様が所有し、クライアントのお客様に適用されているラベルのリソース名。ラベルのリソース名の形式は次のとおりです。 
  | 
              
status | 
                
                  
                   クライアント カスタマーのステータス。読み取り専用。  | 
              
client_customer | 
                
                   
 特定の顧客にリンクされているクライアント カスタマーのリソース名。読み取り専用。  | 
              
level | 
                
                   
 特定のお客様とクライアント間の距離。セルフリンクの場合、レベル値は 0 になります。読み取り専用。  | 
              
time_zone | 
                
                   
 クライアントのタイムゾーンの Common Locale Data Repository(CLDR)文字列表現(例: America/Los_Angeles)。読み取り専用。  | 
              
test_account | 
                
                   
 クライアントがテスト アカウントかどうかを識別します。読み取り専用。  | 
              
manager | 
                
                   
 クライアントがマネージャーかどうかを識別します。読み取り専用。  | 
              
descriptive_name | 
                
                   
 クライアントのわかりやすい名前。読み取り専用。  | 
              
currency_code | 
                
                   
 クライアントの通貨コード(例:「USD」、「EUR」)。読み取り専用。  | 
              
id | 
                
                   
 クライアントのお客様の ID。読み取り専用。  | 
              
CustomerManagerLink
お客様とマネージャーのリンク関係を表します。
| フィールド | |
|---|---|
resource_name | 
                
                   
 リソースの名前。CustomerManagerLink リソース名の形式は   | 
              
status | 
                
                  
                   お客様とマネージャー間のリンクのステータス。  | 
              
manager_customer | 
                
                   
 お客様にリンクされているマネージャー カスタマー。  | 
              
manager_link_id | 
                
                   
 お客様とマネージャーのリンクの ID。このフィールドは読み取り専用です。  | 
              
start_time | 
                
                   
 CustomerManagerLink が作成されたときのタイムスタンプ。このタイムスタンプは、顧客のタイムゾーンを「yyyy-MM-dd HH:mm:ss」形式で指定します。  | 
              
DoubleClickCampaignManagerSetting
マネージャーのお客様の DoubleClick Campaign Manager(DCM)の設定。
| フィールド | |
|---|---|
advertiser_id | 
                
                   
 このお客様に関連付けられているキャンペーン マネージャーの広告主の ID。  | 
              
network_id | 
                
                   
 このお客様に関連付けられているキャンペーン マネージャー ネットワークの ID。  | 
              
time_zone | 
                
                   
 このお客様に関連付けられているキャンペーン マネージャー ネットワークのタイムゾーン(IANA タイムゾーン データベース形式、例: America/New_York)。  | 
              
DynamicSearchAdsSearchTermView
動的検索広告の検索語句ビュー。
| フィールド | |
|---|---|
resource_name | 
                
                   
 動的検索広告の検索語句ビューのリソース名。動的検索広告の検索語句ビューのリソース名の形式は次のとおりです。 
  | 
              
landing_page | 
                
                   
 インプレッションの動的に選択されたランディング ページ URL。 このフィールドは読み取り専用です。  | 
              
GenderView
性別ビュー。gender_view リソースには、追加された条件ではなく、有効な配信ステータスが反映されます。性別の条件が設定されていない広告グループは、デフォルトですべての性別に表示されるため、gender_view にはすべての性別と統計情報が表示されます。
| フィールド | |
|---|---|
resource_name | 
                
                   
 性別ビューのリソース名。性別ビューのリソース名の形式は次のとおりです。 
  | 
              
GeoTargetConstant
地域ターゲティング定数。
| フィールド | |
|---|---|
resource_name | 
                
                   
 地域ターゲティング定数のリソース名。地域ターゲティング定数リソース名の形式は次のとおりです。 
  | 
              
status | 
                
                  
                   地域ターゲティング定数のステータス。  | 
              
id | 
                
                   
 地域ターゲティング定数の ID。  | 
              
name | 
                
                   
 地域ターゲティング定数の英語名。  | 
              
country_code | 
                
                   
 ターゲット地域に関連付けられる国コード(ISO-3166-1 alpha-2)です。  | 
              
target_type | 
                
                   
 地域ターゲティング定数のターゲット タイプ。  | 
              
canonical_name | 
                
                   
 ターゲットの名前と、その地域が属する親地域と国の名前がすべて正規の英語名で含まれます。  | 
              
parent_geo_target | 
                
                   
 親の地域ターゲティング定数のリソース名。地域ターゲティング定数リソース名の形式は次のとおりです。 
  | 
              
KeywordView
キーワード ビュー。
| フィールド | |
|---|---|
resource_name | 
                
                   
 キーワードビューのリソース名。キーワード ビューのリソース名の形式は次のとおりです。 
  | 
              
ラベル
ラベル。
| フィールド | |
|---|---|
resource_name | 
                
                   
 リソースの名前。ラベルのリソース名の形式は   | 
              
status | 
                
                  
                   ラベルのステータス。読み取り専用。  | 
              
text_label | 
                
                  
                   色付きの背景にテキストを表示するラベルの一種。  | 
              
id | 
                
                   
 ラベルの ID。読み取り専用。  | 
              
name | 
                
                   
 ラベルの名前。 このフィールドは必須で、新しいラベルを作成するときに空にすることはできません。 この文字列の長さは 1~80 で指定します。  | 
              
LanguageConstant
言語。
| フィールド | |
|---|---|
resource_name | 
                
                   
 言語定数のリソース名。言語定数リソース名の形式は次のとおりです。 
  | 
              
id | 
                
                   
 言語定数の ID。  | 
              
code | 
                
                   
 言語コード(例: "en_US"、"en_AU"、"es"、"fr" など)。  | 
              
name | 
                
                   
 言語の完全な名前(英語)(例:「英語(米国)」、「スペイン語」など)。  | 
              
targetable | 
                
                   
 言語をターゲットに設定できるかどうか。  | 
              
ListingGroupFilterDimension
アセット グループのリスティング グループのフィルタのリスティング ディメンション。
| フィールド | |
|---|---|
共用体フィールド dimension。次のいずれかのタイプのディメンションは常に存在します。dimension は次のいずれかになります。 | 
              |
product_bidding_category | 
                
                  
                   商品オファーの入札カテゴリ。  | 
              
product_brand | 
                
                  
                   商品のブランド。  | 
              
product_channel | 
                
                  
                   商品の提供地域。  | 
              
product_condition | 
                
                  
                   商品の状態。  | 
              
product_custom_attribute | 
                
                  
                   商品アイテムのカスタム属性。  | 
              
product_item_id | 
                
                  
                   商品アイテム ID。  | 
              
product_type | 
                
                  
                   商品特典の種類。  | 
              
ProductBiddingCategory
特定のレベルの入札カテゴリの 1 つの要素。最上位のカテゴリはレベル 1、その子カテゴリはレベル 2 となります。現在、サポートされているレベルは最大 5 レベルです。ユーザーは、カテゴリのレベルを示すディメンション タイプを指定する必要があります。同じサブディビジョンのケースはすべて、同じディメンション タイプ(カテゴリ レベル)にする必要があります。
| フィールド | |
|---|---|
level | 
                
                   
 分類内のカテゴリのレベルを示します。  | 
              
id | 
                
                   
 商品の入札カテゴリの ID。 この ID は、https://support.google.com/merchants/answer/6324436 の記事で説明されている google_product_category ID と同じです。  | 
              
ProductBrand
商品のブランド。
| フィールド | |
|---|---|
value | 
                
                   
 商品ブランドの文字列値。  | 
              
ProductChannel
商品の提供地域。
| フィールド | |
|---|---|
channel | 
                
                   
 ローカリティの値。  | 
              
ProductCondition
商品の状態。
| フィールド | |
|---|---|
condition | 
                
                   
 条件の値。  | 
              
ProductCustomAttribute
商品アイテムのカスタム属性。
| フィールド | |
|---|---|
index | 
                
                   
 カスタム属性のインデックスを示します。  | 
              
value | 
                
                   
 商品カスタム属性の文字列値。  | 
              
ProductItemId
商品アイテム ID。
| フィールド | |
|---|---|
value | 
                
                   
 ID の値。  | 
              
ProductType
商品特典の種類。
| フィールド | |
|---|---|
level | 
                
                   
 タイプのレベル。  | 
              
value | 
                
                   
 型の値。  | 
              
ListingGroupFilterDimensionPath
リスティング グループ フィルタを定義するディメンションを定義するパス。
| フィールド | |
|---|---|
dimensions[] | 
                
                  
                   リスティング グループ フィルタ階層(ルートノードは除く)からこのリスティング グループ フィルタまでのディメンションの完全なパス。  | 
              
LocationView
地域ビューでは、地域の条件別にキャンペーンのパフォーマンスの概要を確認できます。
| フィールド | |
|---|---|
resource_name | 
                
                   
 ロケーション ビューのリソース名。ロケーション ビューのリソース名の形式は次のとおりです。 
  | 
              
ProductBiddingCategoryConstant
商品入札カテゴリ。
| フィールド | |
|---|---|
resource_name | 
                
                   
 商品入札カテゴリのリソース名。商品入札カテゴリのリソース名の形式は次のとおりです。 
  | 
              
level | 
                
                  
                   商品の入札カテゴリのレベル。  | 
              
status | 
                
                  
                   商品の入札カテゴリのステータス。  | 
              
id | 
                
                   
 商品の入札カテゴリの ID。 この ID は、https://support.google.com/merchants/answer/6324436 の記事で説明されている google_product_category ID と同じです。  | 
              
country_code | 
                
                   
 商品の入札カテゴリの 2 文字の大文字の国コード。  | 
              
product_bidding_category_constant_parent | 
                
                   
 親商品の入札カテゴリのリソース名。  | 
              
language_code | 
                
                   
 商品の入札カテゴリの言語コード。  | 
              
localized_name | 
                
                   
 language_code に応じてローカライズされた商品入札カテゴリの値を表示します。  | 
              
ProductGroupView
商品グループビュー。
| フィールド | |
|---|---|
resource_name | 
                
                   
 商品グループビューのリソース名。商品グループビューのリソース名の形式は次のとおりです。 
  | 
              
SearchAds360Field
SearchAds360Service で使用されるフィールドまたはリソース(アーティファクト)。
| フィールド | |
|---|---|
resource_name | 
                
                   
 アーティファクトのリソース名。アーティファクト リソース名の形式は次のとおりです。 
  | 
              
category | 
                
                  
                   アーティファクトのカテゴリ。  | 
              
selectable_with[] | 
                
                   
 説明されているアーティファクトで選択可能なすべてのリソース、セグメント、指標の名前。  | 
              
attribute_resources[] | 
                
                   
 説明されているアーティファクトで選択可能なすべてのリソースの名前。これらのリソースのフィールドは、検索クエリに含めても指標をセグメント化しません。 このフィールドは、カテゴリが RESOURCE のアーティファクトにのみ設定されます。  | 
              
metrics[] | 
                
                   
 このフィールドには、FROM 句で使用された場合に、記述されたアーティファクトで選択できるすべての指標の名前が一覧表示されます。カテゴリが RESOURCE のアーティファクトにのみ設定されます。  | 
              
segments[] | 
                
                   
 このフィールドには、検索クエリに含まれるセグメント指標と、説明されているアーティファクトが FROM 句で使用されるすべてのアーティファクト(セグメントまたは他のリソース)の名前が一覧表示されます。カテゴリが RESOURCE のアーティファクトにのみ設定されます。  | 
              
enum_values[] | 
                
                   
 アーティファクトが ENUM 型のフィールドである場合に、アーティファクトが想定できる値。 このフィールドは、カテゴリ SEGMENT または ATTRIBUTE のアーティファクトにのみ設定されます。  | 
              
data_type | 
                
                  
                   このフィールドは、WHERE 句でアーティファクトで使用できる演算子を決定します。  | 
              
name | 
                
                   
 アーティファクトの名前。  | 
              
selectable | 
                
                   
 アーティファクトを検索クエリの SELECT 句で使用できるかどうか。  | 
              
filterable | 
                
                   
 アーティファクトを検索クエリの WHERE 句で使用できるかどうか。  | 
              
sortable | 
                
                   
 アーティファクトを検索クエリの ORDER BY 句で使用できるかどうか。  | 
              
type_url | 
                
                   
 アーティファクトのデータ型を記述する proto の URL。  | 
              
is_repeated | 
                
                   
 フィールド アーティファクトが繰り返されるかどうか。  | 
              
ShoppingPerformanceView
ショッピングの掲載結果ビュー。複数の商品ディメンション レベルで集計されたショッピング キャンペーンの統計情報を提供します。Merchant Center の商品ディメンションの値(ブランド、カテゴリ、カスタム属性、商品の状態、商品カテゴリなど)には、対応するイベントが記録された日時における各ディメンションの状態が反映されます。
| フィールド | |
|---|---|
resource_name | 
                
                   
 ショッピングの掲載結果ビューのリソース名。ショッピングのパフォーマンス ビューのリソース名の形式は   | 
              
UserList
ユーザーリスト。お客様がターゲットとするユーザーのリストです。
| フィールド | |
|---|---|
resource_name | 
                
                   
 ユーザーリストのリソース名。ユーザーリストのリソース名の形式は次のとおりです。 
  | 
              
type | 
                
                  
                   このリストのタイプ。 このフィールドは読み取り専用です。  | 
              
id | 
                
                   
 ユーザーリストの ID。  | 
              
name | 
                
                   
 このユーザーリストの名前。access_reason によっては、ユーザーリスト名が一意にならない場合があります(access_reason=SHARED の場合など)。  | 
              
UserLocationView
ユーザーの位置情報のビュー。
ユーザーの位置情報ビューには、国レベルで集計されたすべての指標が国ごとに 1 行ずつ表示されます。対象地域と非対象地域別に、ユーザーの実際の所在地における指標がレポートされます。他のセグメント フィールドを使用している場合は、国ごとに複数の行が返されることがあります。
| フィールド | |
|---|---|
resource_name | 
                
                   
 ユーザーの位置情報ビューのリソース名。UserLocation ビューのリソース名の形式は次のとおりです。 
  | 
              
country_criterion_id | 
                
                   
 国の条件 ID。  | 
              
targeting_location | 
                
                   
 場所がターゲティングされたかどうかを示します。  | 
              
アクセス
訪問。
| フィールド | |
|---|---|
resource_name | 
                
                   
 訪問のリソース名。アクセス リソース名の形式は次のとおりです。 
  | 
              
id | 
                
                   
 訪問の ID。  | 
              
criterion_id | 
                
                   
 Search Ads 360 キーワード ID。値 0 は、キーワードが関連付けられていないことを示します。  | 
              
merchant_id | 
                
                   
 クリックされた商品を含む検索広告 360 在庫アカウント ID。検索広告 360 内で在庫アカウントをリンクすると、検索広告 360 でこの ID が生成されます。  | 
              
ad_id | 
                
                   
 広告 ID。値 0 は、広告が関連付けられていないことを示します。  | 
              
click_id | 
                
                   
 クリック ID URL パラメータとしてランディング ページに渡される、訪問ごとの一意の文字列。  | 
              
visit_date_time | 
                
                   
 訪問イベントのタイムスタンプ。このタイムスタンプは、顧客のタイムゾーンを「yyyy-MM-dd HH:mm:ss」形式で指定します。  | 
              
product_id | 
                
                   
 クリックされた商品の ID。  | 
              
product_channel | 
                
                  
                   クリックされた商品の販売チャネル: オンラインまたはローカル。  | 
              
product_language_code | 
                
                   
 商品に関するデータを含む Merchant Center フィードに設定されている言語(ISO-639-1)。  | 
              
product_store_id | 
                
                   
 クリックされたローカル在庫広告のストア。この ID はローカル商品フィードで使用されているストア ID と一致する必要があります。  | 
              
product_country_code | 
                
                   
 クリックされた商品を含む在庫フィードに登録されている国(ISO-3166 形式)。  | 
              
asset_id | 
                
                   
 アクセス イベント中に操作されたアセットの ID。  | 
              
asset_field_type | 
                
                  
                   アクセス イベントのアセット フィールド タイプ。  | 
              
WebpageView
ウェブページ ビュー。
| フィールド | |
|---|---|
resource_name | 
                
                   
 ウェブページ ビューのリソース名。ウェブページ ビューのリソース名の形式は次のとおりです。 
  |