- JSON 表現
- AssetType
- AssetPolicySummary
- AssetFieldTypePolicySummary
- YoutubeVideoAsset
- MediaBundleAsset
- ImageAsset
- ImageDimension
- TextAsset
- LeadFormAsset
- LeadFormCallToActionType
- LeadFormField
- LeadFormSingleChoiceAnswers
- LeadFormCustomQuestionField
- LeadFormDeliveryMethod
- WebhookDelivery
- LeadFormPostSubmitCallToActionType
- LeadFormDesiredIntent
- BookOnGoogleAsset
- PromotionAsset
- CalloutAsset
- StructuredSnippetAsset
- SitelinkAsset
- PageFeedAsset
- DynamicEducationAsset
- MobileAppAsset
- HotelCalloutAsset
- CallAsset
- PriceAsset
- PriceOffering
- CallToActionAsset
- DynamicRealEstateAsset
- DynamicCustomAsset
- DynamicHotelsAndRentalsAsset
- DynamicFlightsAsset
- DiscoveryCarouselCardAsset
- DynamicTravelAsset
- DynamicLocalAsset
- DynamicJobsAsset
- LocationAsset
- BusinessProfileLocation
- HotelPropertyAsset
アセットは広告の一部で、複数の広告で共有できます。画像(ImageAsset)や動画(YouTubeVideoAsset)などを使用できます。アセットは変更できず、削除できません。アセットの配信を停止するには、そのアセットを使用しているエンティティからアセットを削除します。
JSON 表現 |
---|
{ "resourceName": string, "type": enum ( |
フィールド | |
---|---|
resourceName |
変更不可。アセットのリソース名。アセットのリソース名の形式は次のとおりです。
|
type |
出力のみ。アセットのタイプ。 |
finalUrls[] |
すべてのクロスドメイン リダイレクト後の最終ページ URL のリスト。 |
finalMobileUrls[] |
すべてのクロスドメイン リダイレクト後のモバイルの最終ページ URL のリスト。 |
urlCustomParameters[] |
TrackingUrlTemplate、finalUrls、finalMobileUrls の URL カスタム パラメータ タグの置換に使用するマッピングのリスト。 |
source |
出力のみ。アセットのソース。 |
policySummary |
出力のみ。アセットのポリシー情報。 |
fieldTypePolicySummaries[] |
出力のみ。各 FieldType のアセットに関するポリシー情報。 |
id |
出力のみ。アセットの ID。 |
name |
アセットの名前(省略可)。 |
trackingUrlTemplate |
トラッキング URL を作成するための URL テンプレート。 |
finalUrlSuffix |
並行トラッキングで配信されるランディング ページ URL にパラメータを追加するための URL テンプレート。 |
共用体フィールド asset_data 。アセットの特定のタイプ。asset_data は次のいずれかになります。 |
|
youtubeVideoAsset |
変更不可。YouTube 動画アセット。 |
mediaBundleAsset |
変更不可。メディア バンドル アセット。 |
imageAsset |
出力のみ。画像アセット。 |
textAsset |
変更不可。テキスト アセット。 |
leadFormAsset |
リードフォーム アセット。 |
bookOnGoogleAsset |
Google の書籍アセット。 |
promotionAsset |
プロモーション アセット。 |
calloutAsset |
コールアウト アセット。 |
structuredSnippetAsset |
構造化スニペット アセット。 |
sitelinkAsset |
サイトリンク アセット。 |
pageFeedAsset |
ページフィードのアセット。 |
dynamicEducationAsset |
動的な教育アセット。 |
mobileAppAsset |
モバイルアプリのアセット。 |
hotelCalloutAsset |
ホテルのコールアウト アセット。 |
callAsset |
電話番号アセット。 |
priceAsset |
価格アセット。 |
callToActionAsset |
変更不可。行動を促すフレーズのアセット。 |
dynamicRealEstateAsset |
動的な不動産アセット。 |
dynamicCustomAsset |
動的なカスタム アセット。 |
dynamicHotelsAndRentalsAsset |
ホテルと民泊用の動的なアセット。 |
dynamicFlightsAsset |
動的なフライト アセット。 |
discoveryCarouselCardAsset |
変更不可。ファインド カルーセル カード アセット。 |
dynamicTravelAsset |
動的な旅行アセット。 |
dynamicLocalAsset |
動的なローカル アセット。 |
dynamicJobsAsset |
動的な求人アセット。 |
locationAsset |
出力のみ。住所アセット。 |
hotelPropertyAsset |
変更不可。ホテル物件のアセット。 |
AssetType
使用可能なアセットタイプを記述する列挙型。
列挙型 | |
---|---|
UNSPECIFIED |
指定されていません。 |
UNKNOWN |
戻り値にのみ使用されます。このバージョンで不明な値を表します。 |
YOUTUBE_VIDEO |
YouTube 動画アセット。 |
MEDIA_BUNDLE |
メディア バンドル アセット。 |
IMAGE |
画像アセット。 |
TEXT |
テキスト アセット。 |
LEAD_FORM |
リードフォーム アセット。 |
BOOK_ON_GOOGLE |
「Google で予約」アセット。 |
PROMOTION |
プロモーション アセット。 |
CALLOUT |
コールアウト アセット。 |
STRUCTURED_SNIPPET |
構造化スニペット アセット。 |
SITELINK |
サイトリンク アセット。 |
PAGE_FEED |
ページフィード アセット。 |
DYNAMIC_EDUCATION |
動的な教育アセット。 |
MOBILE_APP |
モバイルアプリ アセット。 |
HOTEL_CALLOUT |
ホテル コールアウト アセット。 |
CALL |
電話番号アセット。 |
PRICE |
価格アセット。 |
CALL_TO_ACTION |
行動を促すフレーズのアセット。 |
DYNAMIC_REAL_ESTATE |
動的な不動産アセット。 |
DYNAMIC_CUSTOM |
動的なカスタム アセット。 |
DYNAMIC_HOTELS_AND_RENTALS |
ホテルと賃貸物件の動的なアセット。 |
DYNAMIC_FLIGHTS |
動的なフライト アセット。 |
DISCOVERY_CAROUSEL_CARD |
ファインド カルーセル カードのアセット。 |
DYNAMIC_TRAVEL |
動的な旅行アセット。 |
DYNAMIC_LOCAL |
動的なローカル アセット。 |
DYNAMIC_JOBS |
動的な求人アセット。 |
LOCATION |
住所アセット。 |
HOTEL_PROPERTY |
ホテル物件のアセット。 |
AssetPolicySummary
アセットのポリシー情報が含まれます。
JSON 表現 |
---|
{ "policyTopicEntries": [ { object ( |
フィールド | |
---|---|
policyTopicEntries[] |
出力のみ。このアセットに対するポリシーの検出結果のリスト。 |
reviewStatus |
出力のみ。審査プロセスのどの段階にあるか。 |
approvalStatus |
出力のみ。このアセットの全体的な承認ステータス。個々のポリシー トピック エントリのステータスに基づいて計算されます。 |
AssetFieldTypePolicySummary
AssetFieldType コンテキストのアセットに関するポリシー情報が含まれます。
JSON 表現 |
---|
{ "assetFieldType": enum ( |
フィールド | |
---|---|
assetFieldType |
出力のみ。このアセットの FieldType。 |
assetSource |
出力のみ。このアセットのソース。 |
policySummaryInfo |
出力のみ。ポリシーの概要 |
YoutubeVideoAsset
YouTube アセット。
JSON 表現 |
---|
{ "youtubeVideoTitle": string, "youtubeVideoId": string } |
フィールド | |
---|---|
youtubeVideoTitle |
YouTube 動画のタイトル。 |
youtubeVideoId |
YouTube 動画 ID。YouTube 動画の URL で使用される 11 文字の文字列値です。 |
MediaBundleAsset
MediaBundle アセット。
JSON 表現 |
---|
{ "data": string } |
フィールド | |
---|---|
data |
メディア バンドル(ZIP ファイル)のアセットデータ。アップロードする ZIP ファイルの形式は、使用する広告フィールドによって異なります。このフォーマットについて詳しくは、MediaBundleAsset を使用する予定の広告フィールドのドキュメントをご覧ください。このフィールドは変更のみ可能です。 Base64 でエンコードされた文字列。 |
ImageAsset
画像アセット。
JSON 表現 |
---|
{ "mimeType": enum ( |
フィールド | |
---|---|
mimeType |
画像アセットの MIME タイプ。 |
fullSize |
元のサイズでこの画像のメタデータ。 |
data |
画像の RAW バイトデータです。このフィールドは変更のみ可能です。 Base64 でエンコードされた文字列。 |
fileSize |
画像アセットのファイルサイズ(バイト単位)。 |
ImageDimension
特定のサイズ(元のサイズまたはサイズ変更された画像)の画像のメタデータ。
JSON 表現 |
---|
{ "heightPixels": string, "widthPixels": string, "url": string } |
フィールド | |
---|---|
heightPixels |
画像の高さ。 |
widthPixels |
画像の幅。 |
url |
この高さと幅の画像を返す URL。 |
TextAsset
テキスト アセット。
JSON 表現 |
---|
{ "text": string } |
フィールド | |
---|---|
text |
テキスト アセットのテキスト コンテンツ。 |
LeadFormAsset
リードフォーム アセット。
JSON 表現 |
---|
{ "businessName": string, "callToActionType": enum ( |
フィールド | |
---|---|
businessName |
必須。宣伝するビジネスの名前です。 |
callToActionType |
必須。ユーザーにフォームを開くよう促す事前定義の表示テキスト。 |
callToActionDescription |
必須。ユーザーがフォームを展開したときに何を期待するかについて、明確な価値提案を行うテキスト。 |
headline |
必須。フォームで求められていることや何をサポートしているのかを説明するための、展開されたフォームの見出し。 |
description |
必須。展開されたフォームの詳細な説明。フォームで求められている内容や、フォームでサポートする内容を説明する必要があります。 |
privacyPolicyUrl |
必須。収集したデータの取り扱い(広告主様またはビジネス)に関するポリシーを説明したページへのリンク。 |
fields[] |
入力フィールドの順序付きリスト。この項目は質問を並べ替えれば更新できますが、質問を追加または削除して更新することはできません。 |
customQuestionFields[] |
カスタム質問フィールドの順序付きリスト。この項目では、1 つのフォームにつき 5 つの質問に回答できます。 |
deliveryMethods[] |
収集した見込み顧客データを広告主に配信する方法を設定済み。構成できるメソッドは WebhookDelivery を 1 つだけ指定します。 |
postSubmitCallToActionType |
フォーム送信後にユーザーにアクションを促す事前定義の表示テキスト。 |
desiredIntent |
リードフォームで選択されたインテント(ボリュームの増加、購入見込みの引き上げなど)。 |
postSubmitHeadline |
フォーム送信後に表示されるテキストの見出し。広告主がユーザーをどのようにフォローアップするかを説明するものです。 |
postSubmitDescription |
フォームの送信後に表示される、広告主様がユーザーをどのようにフォローアップするかの詳細な説明。 |
backgroundImageAsset |
背景画像のアセット リソース名。画像のサイズは 1,200×628 にする必要があります。 |
customDisclosure |
リードフォームで、カスタム開示と Google 免責条項が表示されます。許可されたお客様のみがアクセスできます。 |
LeadFormCallToActionType
リードフォームに含まれる行動を促すフレーズのタイプを記述する列挙型。
列挙型 | |
---|---|
UNSPECIFIED |
指定されていません。 |
UNKNOWN |
戻り値にのみ使用されます。このバージョンで不明な値を表します。 |
LEARN_MORE |
詳細 |
GET_QUOTE |
見積もりを依頼。 |
APPLY_NOW |
今すぐお申し込みください。 |
SIGN_UP |
サインアップ |
CONTACT_US |
お問い合わせください。 |
SUBSCRIBE |
登録] をタップします。 |
DOWNLOAD |
ダウンロード] をタップします。 |
BOOK_NOW |
今すぐ予約。 |
GET_OFFER |
特典を入手。 |
REGISTER |
ぜひご登録ください。 |
GET_INFO |
情報を見る |
REQUEST_DEMO |
デモをリクエストする。 |
JOIN_NOW |
今すぐ参加しましょう。 |
GET_STARTED |
スタートガイド |
LeadFormField
フォーム内の 1 つの入力フィールド インスタンス。
JSON 表現 |
---|
{ "inputType": enum ( |
フィールド | |
---|---|
inputType |
入力タイプを記述します。「フルネーム」などの事前定義されたタイプや、「どのタイプの車をお持ちですか?」などの事前に審査された質問を使用できます。 |
共用体フィールド answers 。このフォーム フィールドに入力できる回答の設定を定義します。oneof が設定されていない場合、これは自由形式の回答です。answers は次のいずれかになります。 |
|
singleChoiceAnswers |
単一選択式の質問の回答設定。事前審査済みの質問フィールドに対してのみ設定できます。最低 2 件の回答が必要です。回答は 12 件までです。 |
hasLocationAnswer |
位置情報に関する質問への回答設定。true の場合、キャンペーン/アカウント単位の住所データ(都道府県、市区町村、お店やサービスの名前など)がリードフォームに表示されます。V13.1 より、地域アセットをキャンペーン単位またはアカウント単位で設定している場合、hasLocationAnswer は「ご希望の販売店を教えて」という質問に対してのみ設定できます。 |
LeadFormSingleChoiceAnswers
単一選択式の問題の解答の選択肢を定義します。通常は、多肢選択式のプルダウン リストとして表示されます。
JSON 表現 |
---|
{ "answers": [ string ] } |
フィールド | |
---|---|
answers[] |
1 つの質問フィールドの選択肢のリスト。入力順序によって UI の順序が定義されます。最低 2 件の回答が必要です。回答は 12 件までです。 |
LeadFormCustomQuestionField
フォーム内に 1 つのカスタム質問入力フィールド インスタンス。
JSON 表現 |
---|
{ "customQuestionText": string, // Union field |
フィールド | |
---|---|
customQuestionText |
カスタムの質問欄の正確なテキスト(例: 「どのような車両をお持ちですか?」)。 |
共用体フィールド answers 。このフォーム フィールドに入力できる回答の設定を定義します。oneof が設定されていない場合、これは自由形式の回答です。answers は次のいずれかになります。 |
|
singleChoiceAnswers |
単一選択式の質問の回答設定。回答は 2 ~ 12 件です。 |
hasLocationAnswer |
位置情報に関する質問への回答設定。true の場合、キャンペーン/アカウント単位の住所データ(都道府県、市区町村、お店やサービスの名前など)がリードフォームに表示されます。V13.1 より、地域アセットをキャンペーン単位またはアカウント単位で設定している場合、hasLocationAnswer は「ご希望の販売店を教えて」という質問に対してのみ設定できます。 |
LeadFormDeliveryMethod
見込み顧客を広告主に配信する方法の設定。
JSON 表現 |
---|
{ // Union field |
フィールド | |
---|---|
共用体フィールド delivery_details 。配信のさまざまなサブタイプ。delivery_details は次のいずれかになります。 |
|
webhook |
Webhook による配信方法。 |
WebhookDelivery
Google は、広告主様が指定したエンドポイントに HTTP 呼び出しを行って、見込み顧客を広告主様に通知します。リクエストには、Google がフォーム広告のドキュメントの一部として公開しているスキーマに一致する JSON が含まれています。
JSON 表現 |
---|
{ "advertiserWebhookUrl": string, "googleSecret": string, "payloadSchemaVersion": string } |
フィールド | |
---|---|
advertiserWebhookUrl |
見込み顧客を送信するために広告主様が指定した Webhook URL。 |
googleSecret |
広告主が Webhook ペイロードの一部として設定するなりすまし対策シークレット。 |
payloadSchemaVersion |
この配信インスタンスが使用するスキーマのバージョン。 |
LeadFormPostSubmitCallToActionType
リードフォームの送信後の行動を促すフレーズのタイプを説明する列挙型。
列挙型 | |
---|---|
UNSPECIFIED |
指定されていません。 |
UNKNOWN |
戻り値にのみ使用されます。このバージョンで不明な値を表します。 |
VISIT_SITE |
サイトにアクセス |
DOWNLOAD |
ダウンロード] をタップします。 |
LEARN_MORE |
詳細 |
SHOP_NOW |
今すぐ購入しよう。 |
LeadFormDesiredIntent
発掘された見込み顧客について、選択した意向レベルを記述する列挙型。
列挙型 | |
---|---|
UNSPECIFIED |
指定されていません。 |
UNKNOWN |
戻り値にのみ使用されます。このバージョンで不明な値を表します。 |
LOW_INTENT |
低い質で、より多くの見込み顧客を獲得できます。 |
HIGH_INTENT |
より有望な見込み顧客へのリーチ |
BookOnGoogleAsset
このタイプにはフィールドがありません。
「Google で予約」アセット。Google 経由で予約するようにユーザーをリダイレクトするために使用します。「Google で予約」では、Google で直接予約できるようにリダイレクト URL が変更されます。
PromotionAsset
プロモーション アセット。
JSON 表現 |
---|
{ "promotionTarget": string, "discountModifier": enum ( |
フィールド | |
---|---|
promotionTarget |
必須。プロモーションの対象に関する自由形式の説明です。 |
discountModifier |
割引の対象となるための調整比。 |
redemptionStartDate |
プロモーションを利用できる開始日(yyyy-MM-dd 形式)。 |
redemptionEndDate |
プロモーションを利用できる最終日(yyyy-MM-dd 形式)。 |
occasion |
プロモーションの目的。行事を設定した場合、クーポンの利用期間は、行事に関連付けられた期間内に設定する必要があります。 |
languageCode |
プロモーションの言語。BCP 47 言語タグで表されます。 |
startDate |
このアセットが有効で配信を開始できる開始日(yyyy-MM-dd 形式)。 |
endDate |
このアセットが有効で配信されている最終日(yyyy-MM-dd 形式)。 |
adScheduleTargets[] |
アセットを配信するすべての時間間隔を指定する、重複しないスケジュールのリスト。1 日に最大 6 個のスケジュールを作成できます(合計 42 個)。 |
共用体フィールド discount_type 。割引の種類。割引率または割引額を指定できます。discount_type には次のいずれか 1 つだけを指定できます。 |
|
percentOff |
プロモーションの割引率。1,000,000 = 100%。この値または moneyAmountOff は必須です。 |
moneyAmountOff |
プロモーションの割引額。これか percentOff のいずれかが必要です。 |
共用体フィールド promotion_trigger 。プロモーション トリガー。プロモーション コードによる場合と、対象となる注文額によるプロモーションによる場合があります。promotion_trigger は次のいずれかになります。 |
|
promotionCode |
プロモーションの対象となるためにユーザーが使用する必要があるコード。 |
ordersOverAmount |
ユーザーがプロモーションの対象となるために必要な注文合計額。 |
CalloutAsset
コールアウト アセット。
JSON 表現 |
---|
{
"calloutText": string,
"startDate": string,
"endDate": string,
"adScheduleTargets": [
{
object ( |
フィールド | |
---|---|
calloutText |
必須。コールアウトのテキスト。この文字列の長さは 1~25 で指定します。 |
startDate |
このアセットが有効で配信を開始できる開始日(yyyy-MM-dd 形式)。 |
endDate |
このアセットが有効で配信されている最終日(yyyy-MM-dd 形式)。 |
adScheduleTargets[] |
アセットを配信するすべての時間間隔を指定する、重複しないスケジュールのリスト。1 日に最大 6 個のスケジュールを作成できます(合計 42 個)。 |
StructuredSnippetAsset
構造化スニペット アセット。
JSON 表現 |
---|
{ "header": string, "values": [ string ] } |
フィールド | |
---|---|
header |
必須。スニペットのヘッダー。この文字列は、https://developers.google.com/google-ads/api/reference/data/structured-snippet-headers で定義済みの値のいずれかである必要があります。 |
values[] |
必須。スニペットの値。このコレクションのサイズは 3 ~ 10 の範囲で指定する必要があります。各値の長さは 1 ~ 25 文字にする必要があります。 |
SitelinkAsset
サイトリンク アセット。
JSON 表現 |
---|
{
"linkText": string,
"description1": string,
"description2": string,
"startDate": string,
"endDate": string,
"adScheduleTargets": [
{
object ( |
フィールド | |
---|---|
linkText |
必須。サイトリンクの URL 表示テキスト。この文字列の長さは 1~25 で指定します。 |
description1 |
サイトリンクの説明の 1 行目。設定する場合は、長さを 1~35 の範囲で設定し、description2 も設定する必要があります。 |
description2 |
サイトリンクの説明の 2 行目。設定する場合、長さは 1~35 の範囲で指定する必要があります。また、description1 も設定する必要があります。 |
startDate |
このアセットが有効で配信を開始できる開始日(yyyy-MM-dd 形式)。 |
endDate |
このアセットが有効で配信されている最終日(yyyy-MM-dd 形式)。 |
adScheduleTargets[] |
アセットを配信するすべての時間間隔を指定する、重複しないスケジュールのリスト。1 日に最大 6 個のスケジュールを作成できます(合計 42 個)。 |
PageFeedAsset
ページフィード アセット。
JSON 表現 |
---|
{ "pageUrl": string, "labels": [ string ] } |
フィールド | |
---|---|
pageUrl |
必須。広告主がターゲットとするウェブページ。 |
labels[] |
ページ URL のグループ化に使用されるラベル。 |
DynamicEducationAsset
動的な教育アセット。
JSON 表現 |
---|
{ "programId": string, "locationId": string, "programName": string, "subject": string, "programDescription": string, "schoolName": string, "address": string, "contextualKeywords": [ string ], "androidAppLink": string, "similarProgramIds": [ string ], "iosAppLink": string, "iosAppStoreId": string, "thumbnailImageUrl": string, "imageUrl": string } |
フィールド | |
---|---|
programId |
必須。プログラム ID。英数字の任意のシーケンスで指定できます。一意で、リマーケティング タグの値と一致している必要があります。必須。 |
locationId |
地域 ID。文字と数字の任意のシーケンスを使用でき、一意である必要があります。 |
programName |
必須。プログラム名(例: 看護師)。必須。 |
subject |
研究テーマ(健康など) |
programDescription |
プログラムの説明(「看護資格」など)。 |
schoolName |
学校名(例: Mountain View School of Nursing)。 |
address |
次のいずれかの形式で指定できる学校の住所。(1)市区町村、都道府県、コード、国(例: Mountain View, CA, USA)。(2)正式な住所(例: 123 Boulevard St, Mountain View, CA 94043)。(3)DDD 形式の緯度と経度(例: 41.40338、2.17403) |
contextualKeywords[] |
コンテンツ キーワード(看護資格、健康、マウンテンビューなど) |
androidAppLink |
Android ディープリンク(例: android-app://com.example.android/http/example.com/gizmos?1234)。 |
similarProgramIds[] |
Similar program IDs [類似プログラムの ID]。 |
iosAppLink |
iOS ディープリンク(例: exampleApp://content/page)。 |
iosAppStoreId |
iOS App Store の ID。ディープリンクが使用される前にユーザーがアプリをインストール済みかどうかを確認するために使用します。このフィールドを設定する場合は、iosAppLink フィールドも指定する必要があります。 |
thumbnailImageUrl |
サムネイル画像の URL(例: http://www.example.com/thumbnail.png)。サムネイル画像は画像アセットとしてアップロードされません。 |
imageUrl |
画像の URL(例: http://www.example.com/image.png)。画像は画像アセットとしてアップロードされません。 |
MobileAppAsset
モバイルアプリを表すアセット。
JSON 表現 |
---|
{
"appId": string,
"appStore": enum ( |
フィールド | |
---|---|
appId |
必須。モバイルアプリを一意に識別する文字列です。Android の場合は「com.android.ebay」、iOS の場合は「12345689」のように、プラットフォームのネイティブ ID のみを含める必要があります。 |
appStore |
必須。この特定のアプリを配信するアプリケーション ストア。 |
linkText |
必須。広告でリンクがレンダリングされるときに表示されるテキスト。この文字列の長さは 1~25 で指定します。 |
startDate |
このアセットが有効で配信を開始できる開始日(yyyy-MM-dd 形式)。 |
endDate |
このアセットが有効で配信されている最終日(yyyy-MM-dd 形式)。 |
HotelCalloutAsset
ホテルのコールアウトを表すアセット。
JSON 表現 |
---|
{ "text": string, "languageCode": string } |
フィールド | |
---|---|
text |
必須。ホテル コールアウト アセットのテキスト。この文字列の長さは 1~25 で指定します。 |
languageCode |
必須。ホテル コールアウトの言語。BCP 47 言語タグで表されます。 |
CallAsset
電話番号アセット。
JSON 表現 |
---|
{ "countryCode": string, "phoneNumber": string, "callConversionReportingState": enum ( |
フィールド | |
---|---|
countryCode |
必須。電話番号の 2 文字の国コード。例: 「US」、「us」。 |
phoneNumber |
必須。広告主の未加工の電話番号。例: 「1234567890」、「(123)456-7890」 |
callConversionReportingState |
この CallAsset では、独自の通話コンバージョン設定を使用するか、アカウント単位の設定を使用するか、通話コンバージョンを無効にするかを示します。 |
callConversionAction |
通話コンバージョンを関連付けるコンバージョン アクション。設定しない場合は、デフォルトのコンバージョン アクションが使用されます。このフィールドは、callConversionReportingState が USE_RESOURCE_LEVEL_CALL_CONVERSION_ACTION に設定されている場合にのみ有効になります。 |
adScheduleTargets[] |
アセットを配信するすべての時間間隔を指定する、重複しないスケジュールのリスト。1 日に最大 6 個のスケジュールを作成できます(合計 42 個)。 |
PriceAsset
価格オファーのリストを表すアセット。
JSON 表現 |
---|
{ "type": enum ( |
フィールド | |
---|---|
type |
必須。価格アセットのタイプ。 |
priceQualifier |
価格アセットの価格種別です。 |
languageCode |
必須。価格アセットの言語。BCP 47 言語タグで表されます。 |
priceOfferings[] |
価格アセットの価格提案です。このコレクションのサイズは 3 ~ 8 の範囲で指定する必要があります。 |
PriceOffering
PriceAsset 内の単一の価格提案。
JSON 表現 |
---|
{ "header": string, "description": string, "price": { object ( |
フィールド | |
---|---|
header |
必須。価格提案のヘッダー。この文字列の長さは 1~25 で指定します。 |
description |
必須。価格提案の説明。この文字列の長さは 1~25 で指定します。 |
price |
必須。価格提案の価格。 |
unit |
価格提案の価格単位。 |
finalUrl |
必須。すべてのクロスドメイン リダイレクト後の最終ページ URL。 |
finalMobileUrl |
すべてのクロスドメイン リダイレクト後のモバイルの最終ページ URL。 |
CallToActionAsset
行動を促すフレーズのアセット。
JSON 表現 |
---|
{
"callToAction": enum ( |
フィールド | |
---|---|
callToAction |
お気軽にお問い合わせください。 |
DynamicRealEstateAsset
動的な不動産アセット。
JSON 表現 |
---|
{ "listingId": string, "listingName": string, "cityName": string, "description": string, "address": string, "price": string, "imageUrl": string, "propertyType": string, "listingType": string, "contextualKeywords": [ string ], "formattedPrice": string, "androidAppLink": string, "iosAppLink": string, "iosAppStoreId": string, "similarListingIds": [ string ] } |
フィールド | |
---|---|
listingId |
必須。リスティング ID。英数字の任意のシーケンスで指定できます。一意で、リマーケティング タグの値と一致している必要があります。必須。 |
listingName |
必須。リスティング名(例: 大通り Bungalow)。必須。 |
cityName |
都市名(例: Mountain View, California)。 |
description |
説明文(例: ベッド 3 台、バスルーム 2、1,500 平方メートル) |
address |
次のいずれかの形式で指定できる住所。(1)市区町村、都道府県、コード、国(例: Mountain View, CA, USA)。(2)正式な住所(例: 123 Boulevard St, Mountain View, CA 94043)。(3)DDD 形式の緯度と経度(例: 41.40338、2.17403) |
price |
数字の後に英字通貨コード(ISO 4217 規格)が続く価格です。小数点には「.」を使用します(例: 200,000.00 米ドル)。 |
imageUrl |
画像の URL(例: http://www.example.com/image.png)。画像は画像アセットとしてアップロードされません。 |
propertyType |
物件のタイプ(住宅など)。 |
listingType |
Listing type [リスティング タイプ](例: 販売中) |
contextualKeywords[] |
コンテンツ キーワード(「販売中」、「住宅 販売」など)。 |
formattedPrice |
任意の文字で書式設定された価格。設定すると、価格 [price] の代わりにこの属性が使用されます(例: $200,000.00 から)。 |
androidAppLink |
Android ディープリンク(例: android-app://com.example.android/http/example.com/gizmos?1234)。 |
iosAppLink |
iOS ディープリンク(例: exampleApp://content/page)。 |
iosAppStoreId |
iOS App Store の ID。ディープリンクが使用される前にユーザーがアプリをインストール済みかどうかを確認するために使用します。このフィールドを設定する場合は、iosAppLink フィールドも指定する必要があります。 |
similarListingIds[] |
Similar listing IDs [類似リスティング ID]。 |
DynamicCustomAsset
動的なカスタム アセット。
JSON 表現 |
---|
{ "id": string, "id2": string, "itemTitle": string, "itemSubtitle": string, "itemDescription": string, "itemAddress": string, "itemCategory": string, "price": string, "salePrice": string, "formattedPrice": string, "formattedSalePrice": string, "imageUrl": string, "contextualKeywords": [ string ], "androidAppLink": string, "iosAppLink": string, "iosAppStoreId": string, "similarIds": [ string ] } |
フィールド | |
---|---|
id |
必須。ID。文字と数字の任意のシーケンスを指定できます。また、リマーケティング タグの値と一致する一意の ID にする必要があります(例: sedan)。必須。 |
id2 |
ID2。文字と数字の任意のシーケンス(赤など)を指定できます。ID シーケンス(ID + ID2)は一意である必要があります。 |
itemTitle |
必須。商品アイテムのタイトル(「ミッドサイズ セダン」など)。必須。 |
itemSubtitle |
アイテムのサブタイトル(例: マウンテンビューのディーラー)。 |
itemDescription |
商品アイテムの説明(例: 売れ筋の中型車)。 |
itemAddress |
次のいずれかの形式で指定できる商品アイテムの住所。(1)市区町村、都道府県、コード、国(例: Mountain View, CA, USA)。(2)正式な住所(例: 123 Boulevard St, Mountain View, CA 94043)。(3)DDD 形式の緯度と経度(例: 41.40338、2.17403) |
itemCategory |
商品アイテムのカテゴリ(例: セダン)。 |
price |
数字の後に英字通貨コード(ISO 4217 規格)が続く価格です。小数点には「.」を使用します(例: 20,000.00 米ドル)。 |
salePrice |
販売価格。数字の後にアルファベットの通貨コード(ISO 4217 規格)を続けることができます。小数点には「.」を使用します(例: 15,000.00 米ドル)。「price」フィールドより小さい値を指定してください。 |
formattedPrice |
任意の文字で書式設定された価格。設定すると、価格 [price] の代わりにこの属性が使用されます(例: 2,000,000 円から)。 |
formattedSalePrice |
任意の文字で書式設定されたセール価格。設定すると、'セール価格' [sale_price] の代わりにこの属性が使用されます(例: 15,000 ドルでセール中)。 |
imageUrl |
画像の URL(例: http://www.example.com/image.png)。画像は画像アセットとしてアップロードされません。 |
contextualKeywords[] |
コンテンツ キーワード(例: セダン、4 ドア セダン)。 |
androidAppLink |
Android ディープリンク(例: android-app://com.example.android/http/example.com/gizmos?1234)。 |
iosAppLink |
iOS ディープリンク(例: exampleApp://content/page)。 |
iosAppStoreId |
iOS App Store の ID。ディープリンクが使用される前にユーザーがアプリをインストール済みかどうかを確認するために使用します。このフィールドを設定する場合は、iosAppLink フィールドも指定する必要があります。 |
similarIds[] |
Similar IDs [類似 ID]。 |
DynamicHotelsAndRentalsAsset
ホテルと民泊用の動的なアセット。
JSON 表現 |
---|
{ "propertyId": string, "propertyName": string, "imageUrl": string, "destinationName": string, "description": string, "price": string, "salePrice": string, "starRating": string, "category": string, "contextualKeywords": [ string ], "address": string, "androidAppLink": string, "iosAppLink": string, "iosAppStoreId": string, "formattedPrice": string, "formattedSalePrice": string, "similarPropertyIds": [ string ] } |
フィールド | |
---|---|
propertyId |
必須。プロパティ ID。英数字の任意のシーケンスで指定できます。一意で、リマーケティング タグの値と一致している必要があります。必須。 |
propertyName |
必須。宿泊施設名(例: Mountain View Hotel)。必須。 |
imageUrl |
画像の URL(例: http://www.example.com/image.png)。画像は画像アセットとしてアップロードされません。 |
destinationName |
目的地(「ダウンタウン、マウンテン ビュー」など)。 |
description |
説明文(例: サンフランシスコ国際空港に近い)。 |
price |
数字の後に英字通貨コード(ISO 4217 規格)が続く価格です。小数点には「.」を使用します(例: 100.00 米ドル)。 |
salePrice |
ISO 4217 規格。小数点には「.」を使用します(例: 8,000 円)。「price」フィールドより小さい値を指定してください。 |
starRating |
星評価。1 ~ 5 の数値(両端を含む)を指定する必要があります。 |
category |
カテゴリ(「ホテルのスイート」など)。 |
contextualKeywords[] |
コンテンツ キーワード(例: 横浜の「ホテル」、横浜のホテル) |
address |
次のいずれかの形式で指定できる住所。(1)市区町村、都道府県、コード、国(例: Mountain View, CA, USA)。(2)正式な住所(例: 123 Boulevard St, Mountain View, CA 94043)。(3)DDD 形式の緯度と経度(例: 41.40338、2.17403) |
androidAppLink |
Android ディープリンク(例: android-app://com.example.android/http/example.com/gizmos?1234)。 |
iosAppLink |
iOS ディープリンク(例: exampleApp://content/page)。 |
iosAppStoreId |
iOS App Store の ID。ディープリンクが使用される前にユーザーがアプリをインストール済みかどうかを確認するために使用します。このフィールドを設定する場合は、iosAppLink フィールドも指定する必要があります。 |
formattedPrice |
任意の文字で書式設定された価格。設定すると、価格 [price] の代わりにこの属性が使用されます(例: 10,000 円から)。 |
formattedSalePrice |
任意の文字で書式設定されたセール価格。設定すると、'セール価格' [sale_price] の代わりにこの属性が使用されます(例: 8,000 円でセール)。 |
similarPropertyIds[] |
Similar property IDs [類似物件の ID] |
DynamicFlightsAsset
動的なフライト アセット。
JSON 表現 |
---|
{ "destinationId": string, "originId": string, "flightDescription": string, "imageUrl": string, "destinationName": string, "originName": string, "flightPrice": string, "flightSalePrice": string, "formattedPrice": string, "formattedSalePrice": string, "androidAppLink": string, "iosAppLink": string, "iosAppStoreId": string, "similarDestinationIds": [ string ], "customMapping": string } |
フィールド | |
---|---|
destinationId |
必須。リンク先 ID。英数字の任意のシーケンスで指定できます。一意で、リマーケティング タグの値と一致している必要があります。必須。 |
originId |
オリジン ID。文字と数字の任意のシーケンスを指定できます。ID シーケンス(デスティネーション ID + オリジン ID)は一意である必要があります。 |
flightDescription |
必須。フライトの説明(例: チケットを予約)必須。 |
imageUrl |
画像の URL(例: http://www.example.com/image.png)。画像は画像アセットとしてアップロードされません。 |
destinationName |
目的地の名前(例: パリ)。 |
originName |
出発地の名前(例: ロンドン)。 |
flightPrice |
フライトの価格。数字の後に英数字(ISO 4217 規格)の通貨コードを続けることができます。小数点には「.」を使用します(例: 100.00 米ドル)。 |
flightSalePrice |
フライトのセール価格。数字の後に英数字(ISO 4217 規格)の通貨コードを続けることができます。小数点には「.」を使用します(例: 8,000 円)。「flightPrice」フィールドよりも小さくする必要があります。 |
formattedPrice |
任意の文字で書式設定された価格。設定すると、価格 [price] の代わりにこの属性が使用されます(例: 10,000 円から)。 |
formattedSalePrice |
任意の文字で書式設定されたセール価格。設定すると、'セール価格' [sale_price] の代わりにこの属性が使用されます(例: 8,000 円でセール)。 |
androidAppLink |
Android ディープリンク(例: android-app://com.example.android/http/example.com/gizmos?1234)。 |
iosAppLink |
iOS ディープリンク(例: exampleApp://content/page)。 |
iosAppStoreId |
iOS App Store の ID。ディープリンクが使用される前にユーザーがアプリをインストール済みかどうかを確認するために使用します。このフィールドを設定する場合は、iosAppLink フィールドも指定する必要があります。 |
similarDestinationIds[] |
類似目的地 ID(例: PAR、LON)。 |
customMapping |
複数のキーと値を区切り文字(","、"|"、":")で区切ってマッピングできるカスタム フィールド。形式は「 |
DiscoveryCarouselCardAsset
ファインド カルーセル カード アセット。
JSON 表現 |
---|
{ "marketingImageAsset": string, "squareMarketingImageAsset": string, "portraitMarketingImageAsset": string, "headline": string, "callToActionText": string } |
フィールド | |
---|---|
marketingImageAsset |
関連付けられた 1.91:1 のマーケティング画像のアセット リソース名。このアセットまたはスクエアのマーケティング画像アセットは必須です。 |
squareMarketingImageAsset |
関連付けられたスクエアのマーケティング画像のアセット リソース名。このアセットとマーケティング画像アセットのいずれかまたは両方が必要です。 |
portraitMarketingImageAsset |
関連付けられた 4:5 の縦向きのマーケティング画像のアセットのリソース名。 |
headline |
必須。カルーセル カードの見出し。 |
callToActionText |
行動を促すフレーズのテキスト。 |
DynamicTravelAsset
動的な旅行アセット。
JSON 表現 |
---|
{ "destinationId": string, "originId": string, "title": string, "destinationName": string, "destinationAddress": string, "originName": string, "price": string, "salePrice": string, "formattedPrice": string, "formattedSalePrice": string, "category": string, "contextualKeywords": [ string ], "similarDestinationIds": [ string ], "imageUrl": string, "androidAppLink": string, "iosAppLink": string, "iosAppStoreId": string } |
フィールド | |
---|---|
destinationId |
必須。リンク先 ID。英数字の任意のシーケンスで指定できます。一意で、リマーケティング タグの値と一致している必要があります。必須。 |
originId |
オリジン ID。文字と数字の任意のシーケンスを指定できます。ID シーケンス(デスティネーション ID + オリジン ID)は一意である必要があります。 |
title |
必須。タイトル(例: 電車のチケットを予約する)。必須。 |
destinationName |
目的地の名前(例: パリ)。 |
destinationAddress |
次のいずれかの形式で指定できる宛先アドレス。(1)市区町村、都道府県、コード、国(例: Mountain View, CA, USA)。(2)正式な住所(例: 123 Boulevard St, Mountain View, CA 94043)。(3)DDD 形式の緯度と経度(例: 41.40338、2.17403)。 |
originName |
出発地の名前(例: ロンドン)。 |
price |
価格。数字の後に英字通貨コード(ISO 4217 規格)が続く形式で指定します。小数点には「.」を使用します(例: 100.00 米ドル)。 |
salePrice |
販売価格。数字の後に英数字(ISO 4217 規格)の通貨コードを続けることができます。小数点には「.」を使用します(例: 8,000 円)。「price」フィールドより小さい値を指定してください。 |
formattedPrice |
任意の文字で書式設定された価格。設定すると、価格 [price] の代わりにこの属性が使用されます(例: 10,000 円から)。 |
formattedSalePrice |
任意の文字で書式設定されたセール価格。設定すると、'セール価格' [sale_price] の代わりにこの属性が使用されます(例: 8,000 円でセール)。 |
category |
カテゴリ(例: 高速)。 |
contextualKeywords[] |
コンテンツ キーワード(「パリの電車」など)。 |
similarDestinationIds[] |
類似目的地 ID(例: 東京) |
imageUrl |
画像の URL(例: http://www.example.com/image.png)。画像は画像アセットとしてアップロードされません。 |
androidAppLink |
Android ディープリンク(例: android-app://com.example.android/http/example.com/gizmos?1234)。 |
iosAppLink |
iOS ディープリンク(例: exampleApp://content/page)。 |
iosAppStoreId |
iOS App Store の ID。ディープリンクが使用される前にユーザーがアプリをインストール済みかどうかを確認するために使用します。このフィールドを設定する場合は、iosAppLink フィールドも指定する必要があります。 |
DynamicLocalAsset
動的なローカル アセット。
JSON 表現 |
---|
{ "dealId": string, "dealName": string, "subtitle": string, "description": string, "price": string, "salePrice": string, "imageUrl": string, "address": string, "category": string, "contextualKeywords": [ string ], "formattedPrice": string, "formattedSalePrice": string, "androidAppLink": string, "similarDealIds": [ string ], "iosAppLink": string, "iosAppStoreId": string } |
フィールド | |
---|---|
dealId |
必須。取引 ID。文字と数字の任意のシーケンスを指定できます。一意で、リマーケティング タグの値と一致している必要があります。必須。 |
dealName |
必須。セール名(例: Mountain View Grocers の 50% オフ)。必須。 |
subtitle |
サブタイトル(例: 食料品)。 |
description |
説明(例: 「週あたりのお支払いを節約できます」)。 |
price |
価格。数字の後に英字通貨コード(ISO 4217 規格)が続く形式で指定します。小数点には「.」を使用します(例: 100.00 米ドル)。 |
salePrice |
販売価格。数字の後にアルファベットの通貨コード(ISO 4217 規格)を続けることができます。小数点には「.」を使用します(例: 8,000 円)。「price」フィールドより小さい値を指定してください。 |
imageUrl |
画像の URL(例: http://www.example.com/image.png)。画像は画像アセットとしてアップロードされません。 |
address |
次のいずれかの形式で指定できる住所。(1)市区町村、都道府県、コード、国(例: Mountain View, CA, USA)。(2)正式な住所(例: 123 Boulevard St, Mountain View, CA 94043)。(3)DDD 形式の緯度と経度(例: 41.40338、2.17403)。 |
category |
カテゴリ(例: 食品)。 |
contextualKeywords[] |
コンテンツ キーワード(「食料品 クーポンを保存」など)。 |
formattedPrice |
任意の文字で書式設定された価格。設定すると、価格 [price] の代わりにこの属性が使用されます(例: 10,000 円から)。 |
formattedSalePrice |
任意の文字で書式設定されたセール価格。設定すると、'セール価格' [sale_price] の代わりにこの属性が使用されます(例: 8,000 円でセール)。 |
androidAppLink |
Android ディープリンク(例: android-app://com.example.android/http/example.com/gizmos?1234)。 |
similarDealIds[] |
類似取引 ID(例: 1275)。 |
iosAppLink |
iOS ディープリンク(例: exampleApp://content/page)。 |
iosAppStoreId |
iOS App Store の ID。ディープリンクが使用される前にユーザーがアプリをインストール済みかどうかを確認するために使用します。このフィールドを設定する場合は、iosAppLink フィールドも指定する必要があります。 |
DynamicJobsAsset
動的な求人アセット。
JSON 表現 |
---|
{ "jobId": string, "locationId": string, "jobTitle": string, "jobSubtitle": string, "description": string, "imageUrl": string, "jobCategory": string, "contextualKeywords": [ string ], "address": string, "salary": string, "androidAppLink": string, "similarJobIds": [ string ], "iosAppLink": string, "iosAppStoreId": string } |
フィールド | |
---|---|
jobId |
必須。求人 ID。文字と数字の任意のシーケンスを指定できます。一意で、リマーケティング タグの値と一致している必要があります。必須。 |
locationId |
地域 ID。文字と数字の任意のシーケンスを指定できます。ID シーケンス(ジョブ ID + ロケーション ID)は一意である必要があります。 |
jobTitle |
必須。役職(例: ソフトウェア エンジニア)。必須。 |
jobSubtitle |
求人のサブタイトル(例: レベル II)。 |
description |
説明(「技術スキルを適用する」など)。 |
imageUrl |
画像の URL(例: http://www.example.com/image.png)。画像は画像アセットとしてアップロードされません。 |
jobCategory |
職種(例: 技術) |
contextualKeywords[] |
コンテンツ キーワード(例: ソフトウェア エンジニアリングの求人)。 |
address |
次のいずれかの形式で指定できる住所。(1)市区町村、都道府県、コード、国(例: Mountain View, CA, USA)。(2)正式な住所(例: 123 Boulevard St, Mountain View, CA 94043)。(3)DDD 形式の緯度と経度(例: 41.40338、2.17403)。 |
salary |
給与(例: $100,000) |
androidAppLink |
Android ディープリンク(例: android-app://com.example.android/http/example.com/gizmos?1234)。 |
similarJobIds[] |
類似ジョブ ID(例: 1275)。 |
iosAppLink |
iOS ディープリンク(例: exampleApp://content/page)。 |
iosAppStoreId |
iOS App Store の ID。ディープリンクが使用される前にユーザーがアプリをインストール済みかどうかを確認するために使用します。このフィールドを設定する場合は、iosAppLink フィールドも指定する必要があります。 |
LocationAsset
住所アセット。
JSON 表現 |
---|
{ "placeId": string, "businessProfileLocations": [ { object ( |
フィールド | |
---|---|
placeId |
プレイス ID は、Google プレイスのデータベースおよび Google マップで、特定の場所を一意に識別する ID です。このフィールドは、特定のお客様 ID とアセットタイプに対して一意です。Place ID について詳しくは、https://developers.google.com/places/web-service/place-id をご覧ください。 |
businessProfileLocations[] |
顧客のビジネス拠点のリスト。ビジネス プロフィール アカウントから住所アセットを同期している場合にのみ返されます。同じアカウントで、同じ場所 ID を参照する複数のビジネス プロフィールのリスティングを作成できます。 |
locationOwnershipType |
ビジネスのオーナー権限のタイプ。タイプが BUSINESS_OWNER の場合は、住所表示オプションとして表示されます。タイプが AFFILIATE の場合は、アフィリエイト住所として使用されます。 |
BusinessProfileLocation
リンクされたビジネス プロフィール アカウントから同期された、ビジネス プロフィールのビジネス情報。
JSON 表現 |
---|
{ "labels": [ string ], "storeCode": string, "listingId": string } |
フィールド | |
---|---|
labels[] |
広告主様がビジネス プロフィール アカウントでビジネス情報に対して指定したラベル。これはビジネス プロフィール アカウントから同期されます。 |
storeCode |
このビジネス拠点のビジネス プロフィールの店舗コード。これはビジネス プロフィール アカウントから同期されます。 |
listingId |
このビジネス プロフィールのビジネス情報のリスティング ID。これは、リンクされているビジネス プロフィール アカウントから同期されます。 |
HotelPropertyAsset
ホテル物件のアセット。
JSON 表現 |
---|
{ "placeId": string, "hotelAddress": string, "hotelName": string } |
フィールド | |
---|---|
placeId |
プレイス ID は、Google プレイスのデータベースおよび Google マップで、特定の場所を一意に識別する ID です。詳しくは、https://developers.google.com/places/web-service/place-id をご覧ください。 |
hotelAddress |
ホテルの住所。読み取り専用です。 |
hotelName |
ホテル名。読み取り専用です。 |