SearchAds360Row

string

広告グループのリソース名。広告グループのリソース名の形式は次のとおりです。

customers/{customerId}/adGroups/{ad_group_id}

enum (AdGroupStatus)

広告グループのステータス。

enum (AdGroupType)

広告グループのタイプ。

enum (AdGroupAdRotationMode)

広告グループの広告のローテーション モード。

string

この adGroup が作成されたときのタイムスタンプ。このタイムスタンプは、顧客のタイムゾーンを「yyyy-MM-dd HH:mm:ss」形式で指定します。

object (TargetingSetting)

ターゲティング関連の機能の設定です。

string

この広告グループに適用されているラベルのリソース名。

string

この広告グループに適用されている有効なラベルのリソース名。有効なラベルとは、この広告グループに継承または直接割り当てられているラベルです。

string

外部エンジン アカウントの広告グループの ID。このフィールドは、Google 広告アカウント以外のアカウントにのみ使用できます（Yahoo! Japan、Microsoft、Baidu など）。Google 広告エンティティの場合は、代わりに「adGroup.id」を使用します。

string

この広告グループの広告配信を開始する日付。デフォルトでは、広告グループの開始日は、現在または開始日のいずれか遅い方になります。このフィールドを設定した場合、ユーザーのタイムゾーンで指定の日付の開始時間に広告グループが開始されます。このフィールドは、Microsoft Advertising アカウントと Facebook ゲートウェイ アカウントでのみ使用できます。

形式: YYYY-MM-DD 例: 2019-03-14

string

広告グループの広告配信を終了する日付。デフォルトでは、広告グループは広告グループの終了日に終了します。このフィールドが設定されている場合、ユーザーのタイムゾーンで指定の日付に広告グループが終了します。このフィールドは、Microsoft Advertising アカウントと Facebook ゲートウェイ アカウントでのみ使用できます。

形式: YYYY-MM-DD 例: 2019-03-14

string

広告グループ内の広告とキーワードの言語。このフィールドは、Microsoft Advertising アカウントでのみご利用いただけます。詳細: https://docs.microsoft.com/en-us/advertising/guides/ad-languages?view=bingads-13#adlanguage

string

この広告グループが最後に変更された日時。日時は、顧客のタイムゾーンの「yyyy-MM-dd HH:mm:ss.ssssss」形式です。

string (int64 format)

広告グループの ID です。

string

広告グループの名前です。

このフィールドは必須です。新しい広告グループを作成する場合は空にしないでください。

含めることができる文字は、UTF-8 の全角で 255 文字未満にする必要があります。

null（コードポイント 0x0）、NL ラインフィード（コードポイント 0xA）、改行（コードポイント 0xD）の文字を含めることはできません。

string (int64 format)

最大 CPC（クリック単価）入札。

enum (AdGroupEngineStatus)

広告グループのエンジン ステータス。

object (TargetRestriction)

ターゲティング ディメンションごとに、キャンペーンまたは広告グループのリーチを制限する設定。

enum (TargetingDimension)

これらの設定が適用されるターゲティング ディメンション。

boolean

このターゲティング ディメンションで選択した条件にのみ広告を表示するか、このターゲティング ディメンションのすべての値をターゲットに設定し、他のターゲティング ディメンションでのターゲティングに基づいて広告を表示するかを指定します。値を true にした場合、これらの条件は入札単価調整比のみ適用され、ターゲティングには影響しないことを意味します。値が false の場合、これらの条件によってターゲティングが制限され、入札単価調整比が適用されます。

string

広告のリソース名。広告グループ広告のリソース名の形式は次のとおりです。

customers/{customerId}/adGroupAds/{ad_group_id}~{adId}

enum (AdGroupAdStatus)

広告のステータスです。

object (Ad)

広告。

string

この adGroupAd が作成されたときのタイムスタンプ。日時は、顧客のタイムゾーンの「yyyy-MM-dd HH:mm:ss.ssssss」形式です。

string

この広告グループの広告に適用されているラベルのリソース名。

string

この広告に適用されている有効なラベルのリソース名。有効なラベルとは、この広告に継承されているラベルまたは直接割り当てられているラベルです。

string

外部エンジン アカウントの広告の ID。このフィールドは検索広告 360 アカウント（Yahoo、Microsoft、Baidu など）専用です。検索広告 360 以外のエンティティの場合は、代わりに「adGroupAd.ad.id」を使用します。

enum (AdGroupAdEngineStatus)

外部エンジン アカウントの広告の追加ステータス。外部アカウントの種類によって、アクティブ、有効、確認待ちなどのステータスが表示されます。

string

この広告グループの広告が最後に変更された日時。日時は、顧客のタイムゾーンの「yyyy-MM-dd HH:mm:ss.ssssss」形式です。

string

広告のリソース名。広告リソース名の形式は次のとおりです。

customers/{customerId}/ads/{adId}

string

広告のすべてのクロスドメイン リダイレクトの後に可能性のある最終ページ URL のリスト。

enum (AdType)

広告タイプ。

string (int64 format)

広告の ID です。

string

一部の広告フォーマットの広告説明に表示される URL。

string

広告の名前。広告を識別するためにのみ使用されます。一意である必要はなく、配信される広告には影響しません。name フィールドは現在、DisplayUploadAd、ImageAd、ShoppingComparisonListingAd、VideoAd でのみサポートされています。

object (SearchAds360TextAdInfo)

テキスト広告に関する詳細情報。

object (SearchAds360ExpandedTextAdInfo)

拡張テキスト広告に関する詳細情報。

object (SearchAds360ResponsiveSearchAdInfo)

レスポンシブ検索広告に関する詳細。

object (SearchAds360ProductAdInfo)

商品広告に関する詳細。

object (SearchAds360ExpandedDynamicSearchAdInfo)

拡張動的検索広告に関する詳細。

string

広告の見出しです。

string

広告の説明欄の 1 行目。

string

広告の説明欄の 2 行目。

string

広告の表示 URL。

string

広告の表示されるモバイル URL。

string (int64 format)

広告のトラッキング ID。

string

広告の見出しです。

string

広告の 2 番目の見出し。

string

広告の 3 番目の見出し。

string

広告の説明欄の 1 行目。

string

広告の説明欄の 2 行目。

string

自動生成された表示 URL に区切り文字で追加されるテキスト。

string

区切り文字を使用して path1 に追加されたテキスト。

string (int64 format)

広告のトラッキング ID。

object (AdTextAsset)

広告見出しのテキスト アセットのリスト。広告が配信される際、ヘッドラインはこのリストから選択されます。

object (AdTextAsset)

説明のテキスト アセットのリスト。広告が配信される際、このリストから説明が選択されます。

string

自動生成された表示 URL に付加される、区切り文字付きのテキスト。

string

区切り文字を使用して path1 に追加されたテキスト。

string (int64 format)

広告のトラッキング ID。

string

アセット テキスト。

string

広告の説明欄の 1 行目。

string

広告の説明欄の 2 行目。

string (int64 format)

広告のトラッキング ID。

string

広告グループ広告の有効ラベルのリソース名。広告グループ広告の有効ラベルのリソース名の形式は customers/{customerId}/adGroupAdEffectiveLabels/{ad_group_id}~{adId}~{label_id} です。

string

有効なラベルが付いている広告グループの広告。

string

広告グループ広告に割り当てられる有効なラベル。

string (int64 format)

有効なラベルを所有するお客様の ID。

string

広告グループ広告ラベルのリソース名です。広告グループ広告ラベルのリソース名の形式は customers/{customerId}/adGroupAdLabels/{ad_group_id}~{adId}~{label_id} です。

string

ラベルが添付される広告グループ広告。

string

広告グループ広告に割り当てられるラベル。

string (int64 format)

ラベルを所有するお客様の ID。

string

広告グループ アセットのリソース名。AdGroupAsset リソース名の形式は次のとおりです。

customers/{customerId}/adGroupAssets/{ad_group_id}~{assetId}~{fieldType}

string

必須。アセットがリンクされている広告グループ。

string

必須。広告グループにリンクされているアセットです。

enum (AssetLinkStatus)

広告グループのアセットのステータス。

string

広告グループのアセットセットのリソース名。広告グループのアセットセットのリソース名の形式は次のとおりです。

customers/{customerId}/adGroupAssetSets/{ad_group_id}~{asset_set_id}

string

このアセットセットがリンクされている広告グループ。

string

広告グループにリンクされているアセットセットです。

enum (AssetSetLinkStatus)

広告グループのアセットセットのステータス。読み取り専用です。

string

広告グループのオーディエンス ビューのリソース名。広告グループ オーディエンス ビューのリソース名の形式は次のとおりです。

customers/{customerId}/adGroupAudienceViews/{ad_group_id}~{criterionId}

string

広告グループの入札単価調整比のリソース名。広告グループの入札単価調整比のリソース名の形式は次のとおりです。

customers/{customerId}/adGroupBidModifiers/{ad_group_id}~{criterionId}

number

条件が一致した場合の入札の修飾子。修飾子は 0.1 ～ 10.0 の範囲内にする必要があります。PreferredContent の範囲は 1.0～6.0 です。デバイスタイプをオプトアウトするには、0 を使用します。

object (DeviceInfo)

デバイスの条件です。

enum (Device)

端末のタイプ。

string

広告グループの条件のリソース名。広告グループの条件のリソース名の形式は次のとおりです。

customers/{customerId}/adGroupCriteria/{ad_group_id}~{criterionId}

string

この広告グループの条件が作成された時点のタイムスタンプ。このタイムスタンプは、顧客のタイムゾーンを「yyyy-MM-dd HH:mm:ss」形式で指定します。

enum (AdGroupCriterionStatus)

条件のステータス。

これは、クライアントが設定した広告グループの条件エンティティのステータスです。注: UI レポートには、条件を実行できるかどうかに影響する追加情報が含まれている場合があります。API では「削除済み」である条件でも、管理画面では有効と表示されることがあります。たとえば、除外していない限り、デフォルトですべての年齢層のユーザーにキャンペーンが表示されます。対象の年齢層は広告が表示されるため、UI には「有効」と表示されます。しかし、非除外条件が追加されていないため、AdGroupCriterion.status には「removed」と表示されます。

object (QualityInfo)

条件の品質に関する情報。

enum (CriterionType)

条件のタイプ。

string

この広告グループの条件に適用されているラベルのリソース名。

string

この広告グループの条件に適用されている有効なラベルのリソース名。有効なラベルとは、この広告グループの条件に継承または直接割り当てられたラベルのことです。

object (PositionEstimates)

さまざまな位置での条件付き入札単価の推定値。

string

広告のすべてのクロスドメイン リダイレクトの後に可能性のある最終ページ URL のリスト。

string

外部エンジン アカウントの広告グループの条件の ID。このフィールドは、Google 広告アカウント以外のアカウントにのみ使用できます（Yahoo! Japan、Microsoft、Baidu など）。Google 広告エンティティの場合は、代わりに「adGroupCriterion.criterion_id」を使用します。

string

この広告グループの条件が最後に変更された日時。日時は、顧客のタイムゾーンの「yyyy-MM-dd HH:mm:ss.ssssss」形式です。

string (int64 format)

条件の ID。

string

条件が属する広告グループです。

boolean

条件をターゲットに設定するか（false）、除外するか（true）を指定します。

このフィールドは変更できません。評価基準を肯定的なものから否定的なものに切り替えるには、条件を削除してから再度追加します。

number

条件が一致した場合の入札の修飾子。修飾子は 0.1 ～ 10.0 の範囲内にする必要があります。対象とする条件タイプのほとんどで、修飾子がサポートされています。

string (int64 format)

クリック単価（CPC）。

string (int64 format)

有効 CPC（クリック単価）入札。

enum (AdGroupCriterionEngineStatus)

広告グループのエンジン ステータスの条件。

string

パラメータを最終ページ URL に追加するための URL テンプレート。

string

トラッキング URL を作成するための URL テンプレート。

object (KeywordInfo)

キーワード。

object (ListingGroupInfo)

リスティング グループ。

object (AgeRangeInfo)

年齢層。

object (GenderInfo)

性別。

object (UserListInfo)

ユーザーリスト。

object (WebpageInfo)

ウェブページ

object (LocationInfo)

位置情報] をタップします。

integer

品質スコア。

Google が値を決定するための十分な情報を持っていない場合は、このフィールドに値が入力されないことがあります。

string (int64 format)

広告が検索結果の最初のページの上部に表示されるために必要なクリック単価の見積もり。

enum (KeywordMatchType)

キーワードのマッチ タイプです。

string

キーワードのテキスト（最大 80 文字、10 単語）。

enum (ListingGroupType)

リスティング グループのタイプ。

enum (AgeRangeType)

年齢層のタイプ。

enum (GenderType)

性別のタイプ。

string

ユーザーリストのリソース名。

object (WebpageConditionInfo)

ウェブページ ターゲティングの条件または論理式。ターゲティングの評価時に、ウェブページのターゲティング条件のリストが 1 つにまとめられます。条件のリストが空の場合は、キャンペーンのウェブサイトのすべてのページがターゲットに設定されていることを示します。

このフィールドは、CREATE オペレーションでは必須であり、UPDATE オペレーションでは禁止されています。

number

ウェブサイトの条件カバレッジの割合。広告グループとキャンペーンのウェブサイト ターゲット、除外ウェブサイト ターゲット、除外キーワードに基づいて計算されたウェブサイトのカバレッジの割合。たとえば、カバレッジが 1 の場合は、カバレッジが 100% であることを示します。このフィールドは読み取り専用です。

string

このパラメータで定義される条件の名前。name の値は、このタイプのパラメータで条件を識別、並べ替え、フィルタするために使用されます。

このフィールドは、CREATE オペレーションでは必須であり、UPDATE オペレーションでは禁止されています。

enum (WebpageConditionOperand)

ウェブページ ターゲティング条件のオペランド。

enum (WebpageConditionOperator)

ウェブページ ターゲティング条件のオペレーター。

string

ウェブページのターゲティング条件の引数。

string

地域ターゲティングの定数リソース名。

string

広告グループ条件の効果ラベルのリソース名。広告グループ条件の有効ラベルのリソース名の形式は customers/{customerId}/adGroupCriterionEffectiveLabels/{ad_group_id}~{criterionId}~{label_id} です。

string

有効なラベルが適用されている広告グループの条件。

string

広告グループの条件に割り当てられている有効なラベル。

string (int64 format)

有効なラベルを所有するお客様の ID。

string

広告グループ条件ラベルのリソース名。広告グループ条件ラベルのリソース名の形式は customers/{customerId}/adGroupCriterionLabels/{ad_group_id}~{criterionId}~{label_id} です。

string

ラベルが添付される広告グループ条件。

string

広告グループの条件に割り当てられているラベル。

string (int64 format)

ラベルを所有するお客様の ID。

string

広告グループの効果ラベルのリソース名。広告グループの有効なラベルのリソース名の形式は customers/{customerId}/adGroupEffectiveLabels/{ad_group_id}~{label_id} です。

string

有効なラベルが設定されている広告グループ。

string

広告グループに割り当てられている有効なラベル。

string (int64 format)

有効なラベルを所有するお客様の ID。

string

広告グループラベルのリソース名。広告グループ ラベルのリソース名の形式は customers/{customerId}/adGroupLabels/{ad_group_id}~{label_id} です。

string

ラベルが添付される広告グループ。

string

広告グループに割り当てられているラベル。

string (int64 format)

ラベルを所有する顧客の ID。

string

年齢層ビューのリソース名。年齢層ビューのリソース名の形式は次のとおりです。

customers/{customerId}/ageRangeViews/{ad_group_id}~{criterionId}

string

アセットのリソース名。アセット リソース名の形式は次のとおりです。

customers/{customerId}/assets/{assetId}

enum (AssetType)

アセットのタイプ。

string

すべてのクロスドメイン リダイレクト後の最終ページ URL のリスト。

enum (AssetStatus)

アセットのステータス。

string

この求人が作成されたときのタイムスタンプ。このタイムスタンプは、顧客のタイムゾーンを「yyyy-MM-dd HH:mm:ss」形式で指定します。

string

このアセットが最後に変更された日時。日時は、顧客のタイムゾーンの「yyyy-MM-dd HH:mm:ss.ssssss」形式です。

string (int64 format)

アセットの ID です。

string

アセットの名前（省略可）。

string

トラッキング URL を作成するための URL テンプレート。

enum (AssetEngineStatus)

アセットのエンジン ステータス。

object (YoutubeVideoAsset)

YouTube 動画アセット。

object (ImageAsset)

画像アセット。

object (TextAsset)

テキスト アセット。

object (UnifiedCalloutAsset)

統合されたコールアウト アセット。

object (UnifiedSitelinkAsset)

統合されたサイトリンク アセット。

object (UnifiedPageFeedAsset)

統合されたページフィード アセット。

object (MobileAppAsset)

モバイルアプリ アセット。

object (UnifiedCallAsset)

統合された電話番号アセット。

object (CallToActionAsset)

行動を促すフレーズのアセット。

object (UnifiedLocationAsset)

統合された住所アセット。

string

YouTube 動画のタイトル。

string

YouTube 動画 ID。YouTube 動画の URL で使用される 11 文字の文字列値です。

enum (MimeType)

画像アセットの MIME タイプ。

object (ImageDimension)

この画像のメタデータ（元のサイズ）。

string (int64 format)

画像アセットのファイルサイズ（バイト単位）。

string (int64 format)

画像の高さ。

string (int64 format)

画像の幅。

string

この高さと幅の画像を返す URL。

string

テキスト アセットのテキスト コンテンツ。

string

コールアウトのテキスト。この文字列の長さは 1～25 で指定します。

string

このアセットが有効になり、配信を開始できる日付（yyyy-MM-dd 形式）。

string

このアセットが有効で配信されている最終日（yyyy-MM-dd 形式）。

object (AdScheduleInfo)

アセットを配信できるすべての時間帯を指定する、重複しないスケジュールのリスト。1 日に設定できるスケジュールは最大 6 つ（合計 42 つ）です。

boolean

検索ユーザーのタイムゾーンでアセットを表示するかどうか。Microsoft Advertising に適用されます。

enum (MinuteOfHour)

このスケジュールが開始される開始時間から経過した分数。

このフィールドは、CREATE オペレーションでは必須であり、UPDATE オペレーションでは禁止されています。

enum (MinuteOfHour)

このスケジュールが終了する終了時間から経過した分数。スケジュールの終了時間は含まれません。

このフィールドは、CREATE オペレーションでは必須であり、UPDATE オペレーションでは禁止されています。

enum (DayOfWeek)

スケジュールが適用される曜日。

このフィールドは、CREATE オペレーションでは必須であり、UPDATE オペレーションでは禁止されています。

integer

開始時間（24 時間形式）。このフィールドは 0 ～ 23 の範囲で指定してください。

このフィールドは、CREATE オペレーションでは必須であり、UPDATE オペレーションでは禁止されています。

integer

終了時間（24 時間表記）。24 は当日を意味します。このフィールドは 0 ～ 24 の範囲で指定してください。

このフィールドは、CREATE オペレーションでは必須であり、UPDATE オペレーションでは禁止されています。

string

サイトリンクの URL 表示テキスト。この文字列の長さは 1～25 で指定します。

string

サイトリンクの説明の 1 行目。設定する場合は、長さを 1～35 の範囲で設定し、description2 も設定する必要があります。

string

サイトリンクの説明の 2 行目。設定する場合、長さは 1～35 の範囲で指定する必要があります。また、description1 も設定する必要があります。

string

このアセットが有効になり、配信を開始できる日付（yyyy-MM-dd 形式）。

string

このアセットが有効で配信されている最終日（yyyy-MM-dd 形式）。

object (AdScheduleInfo)

アセットを配信できるすべての時間帯を指定する、重複しないスケジュールのリスト。1 日に設定できるスケジュールは最大 6 つ（合計 42 つ）です。

string (int64 format)

サイトリンク アセットのクリック トラッキングに使用される ID。これは Yahoo! の日本国内のみのフィールド。

boolean

検索ユーザーのタイムゾーンでサイトリンク アセットを表示するかどうか。Microsoft 広告に適用されます。

boolean

サイトリンク アセットをモバイル デバイスに表示するかどうか。Microsoft Advertising に適用されます。

string

広告主がターゲットに設定するウェブページ。

string

ページの URL をグループ化するために使用されるラベル。

string

必須。モバイルアプリを一意に識別する文字列。プラットフォーム固有の ID（Android の場合は「com.android.ebay」、iOS の場合は「12345689」など）のみを含める必要があります。

enum (MobileAppVendor)

必須。この特定のアプリを配信しているアプリストア。

string

電話番号の 2 文字の国コード。例: 'US'、'us'。

string

広告主の未加工の電話番号。例: '1234567890'、'(123)456-7890'

enum (CallConversionReportingState)

この CallAsset で独自の通話コンバージョン設定を使用するか、アカウント単位の設定に従うか、通話コンバージョンを無効にするかを示します。

string

電話コンバージョンを割り当てるコンバージョン アクション。設定されていない場合は、デフォルトのコンバージョン アクションが使用されます。このフィールドは、callConversionReportingState が USE_RESOURCE_LEVEL_CALL_CONVERSION_ACTION に設定されている場合にのみ有効です。

object (AdScheduleInfo)

アセットを配信できるすべての時間帯を指定する、重複しないスケジュールのリスト。スケジュールは、1 日あたり最大 6 件、合計 42 件まで設定できます。

boolean

通話に電話番号のみが表示され、ウェブサイトへのリンクが表示されないかどうか。Microsoft 広告に適用されます。

boolean

通話を電話トラッキングで有効にするかどうか。Microsoft Advertising に適用されます。

boolean

検索ユーザーのタイムゾーンで通話エクステンションを表示するかどうか。Microsoft Advertising に適用されます。

string

このアセットが有効で配信を開始できる開始日（yyyy-MM-dd 形式）。

string

このアセットが有効で配信されている最終日（yyyy-MM-dd 形式）。

enum (CallToActionType)

お気軽にお問い合わせください。

string

プレイス ID は、Google プレイスのデータベースおよび Google マップで、特定の場所を一意に識別する ID です。このフィールドは、特定のお客様 ID とアセットタイプに対して一意です。Place ID について詳しくは、https://developers.google.com/places/web-service/place-id をご覧ください。

object (BusinessProfileLocation)

お客様のビジネス拠点のリスト。住所アセットがビジネス プロフィール アカウントから同期されている場合にのみ返されます。同じアカウントで、同じプレイス ID を指す複数のビジネス プロフィール リスティングを作成できます。

enum (LocationOwnershipType)

場所の所有権の種類。タイプが BUSINESS_OWNER の場合、住所表示オプションとして配信されます。タイプが AFFILIATE の場合、アフィリエイトの店舗として配信されます。

string

広告主様がビジネス プロフィール アカウントでビジネス拠点に指定したラベル。これはビジネス プロフィール アカウントから同期されます。

string

このビジネス拠点のビジネス プロフィールの店舗コード。これはビジネス プロフィール アカウントから同期されます。

string (int64 format)

このビジネス プロフィールのビジネス拠点のリスティング ID。リンクされたビジネス プロフィール アカウントから同期されます。