- リソース: Ad
- FinalAppUrl
- AppUrlOperatingSystemType
- CustomParameter
- AdType
- デバイス
- UrlCollection
- SystemManagedResourceSource
- TextAdInfo
- ExpandedTextAdInfo
- CallAdInfo
- CallConversionReportingState
- ExpandedDynamicSearchAdInfo
- HotelAdInfo
- ShoppingSmartAdInfo
- ShoppingProductAdInfo
- ImageAdInfo
- MimeType
- AdImageAsset
- VideoAdInfo
- AdVideoAsset
- VideoTrueViewInStreamAdInfo
- VideoBumperInStreamAdInfo
- VideoOutstreamAdInfo
- VideoNonSkippableInStreamAdInfo
- InFeedVideoAdInfo
- VideoThumbnail
- VideoResponsiveAdInfo
- AdTextAsset
- ServedAssetFieldType
- AssetPerformanceLabel
- AdAssetPolicySummary
- PolicyTopicEntry
- PolicyTopicEntryType
- PolicyTopicEvidence
- WebsiteList
- TextList
- DestinationTextList
- DestinationMismatch
- PolicyTopicEvidenceDestinationMismatchUrlType
- DestinationNotWorking
- PolicyTopicEvidenceDestinationNotWorkingDevice
- PolicyTopicEvidenceDestinationNotWorkingDnsErrorType
- PolicyTopicConstraint
- CountryConstraintList
- CountryConstraint
- ResellerConstraint
- PolicyReviewStatus
- PolicyApprovalStatus
- ResponsiveSearchAdInfo
- LegacyResponsiveDisplayAdInfo
- DisplayAdFormatSetting
- AppAdInfo
- AdMediaBundleAsset
- LegacyAppInstallAdInfo
- LegacyAppInstallAdAppStore
- ResponsiveDisplayAdInfo
- ResponsiveDisplayAdControlSpec
- LocalAdInfo
- DisplayUploadAdInfo
- DisplayUploadProductType
- AppEngagementAdInfo
- ShoppingComparisonListingAdInfo
- SmartCampaignAdInfo
- AppPreRegistrationAdInfo
- DiscoveryMultiAssetAdInfo
- DiscoveryCarouselAdInfo
- AdDiscoveryCarouselCardAsset
- DiscoveryVideoResponsiveAdInfo
- AdCallToActionAsset
- TravelAdInfo
- メソッド
リソース: Ad
広告
JSON 表現 |
---|
{ "resourceName": string, "finalUrls": [ string ], "finalAppUrls": [ { object ( |
フィールド | |
---|---|
resourceName |
変更不可。広告のリソース名。広告リソース名の形式は次のとおりです。
|
finalUrls[] |
広告のすべてのクロスドメイン リダイレクト後の転送先となる可能性のある最終ページ URL のリスト。 |
finalAppUrls[] |
特定のアプリがインストールされている場合にモバイルで使用される、アプリの最終リンク先 URL のリスト。 |
finalMobileUrls[] |
広告のすべてのクロスドメイン リダイレクトの後に可能性のあるモバイルの最終ページ URL のリスト。 |
urlCustomParameters[] |
|
type |
出力のみ。広告タイプ。 |
devicePreference |
広告のデバイス設定。設定を指定できるのはモバイル デバイスに対してのみです。この設定が行われる場合、モバイル デバイスで表示される際に他の広告よりも優先されます。他のデバイスタイプでは、他の広告がない場合などに、その広告が引き続き表示されます。指定しない場合(デバイス設定がない場合)、すべてのデバイスがターゲットになります。一部の広告タイプでのみサポートされています。 |
urlCollections[] |
広告の他のフィールドから参照できる、一意の識別子でタグ付けされた広告の追加 URL。 |
systemManagedResourceSource |
出力のみ。広告がシステムで管理される場合、このフィールドはソースを示します。このフィールドは読み取り専用です。 |
id |
出力のみ。広告の ID。 |
trackingUrlTemplate |
トラッキング URL を作成するための URL テンプレート。 |
finalUrlSuffix |
最終ページ URL の作成時に使用するサフィックス。 |
displayUrl |
一部の広告フォーマットの広告説明に表示される URL。 |
addedByGoogleAds |
出力のみ。この広告がユーザーではなく Google 広告によって自動的に追加されたかどうかを示します。たとえば、既存の広告の成果に基づいて、新しい広告の候補として広告が自動作成される場合があります。 |
name |
変更不可。広告の名前。広告を識別するためにのみ使用されます。一意である必要はなく、配信される広告には影響しません。name フィールドは現在、DisplayUploadAd、ImageAd、ShoppingComparisonListingAd、VideoAd でのみサポートされています。 |
共用体フィールド ad_data 。広告タイプに関する詳細情報。必ず 1 つの値を設定する必要があります。ad_data は次のいずれかになります。 |
|
textAd |
変更不可。テキスト広告に関する詳細です。 |
expandedTextAd |
拡張テキスト広告に関する詳細情報です。 |
callAd |
電話専用広告に関する詳細です。 |
expandedDynamicSearchAd |
変更不可。拡張動的検索広告に関する詳細です。この種類の広告は、 |
hotelAd |
ホテル広告に関する詳細。 |
shoppingSmartAd |
スマート ショッピング広告に関する詳細情報。 |
shoppingProductAd |
ショッピング広告に関する詳細です。 |
imageAd |
変更不可。イメージ広告に関する詳細です。 |
videoAd |
動画広告に関する詳細です。 |
videoResponsiveAd |
動画レスポンシブ広告に関する詳細。 |
responsiveSearchAd |
レスポンシブ検索広告に関する詳細。 |
legacyResponsiveDisplayAd |
従来のレスポンシブ ディスプレイ広告に関する詳細。 |
appAd |
アプリ広告に関する詳細情報です。 |
legacyAppInstallAd |
変更不可。従来のアプリ インストール広告に関する詳細です。 |
responsiveDisplayAd |
レスポンシブ ディスプレイ広告に関する詳細。 |
localAd |
ローカル広告に関する詳細です。 |
displayUploadAd |
ディスプレイ アップロード広告に関する詳細情報。 |
appEngagementAd |
アプリ エンゲージメント広告に関する詳細情報。 |
shoppingComparisonListingAd |
ショッピング比較広告に関する詳細。 |
smartCampaignAd |
スマート アシスト キャンペーン広告に関する詳細。 |
appPreRegistrationAd |
アプリ事前登録広告に関する詳細情報です。 |
discoveryMultiAssetAd |
ファインド マルチアセット広告に関する詳細です。 |
discoveryCarouselAd |
ファインド カルーセル広告に関する詳細情報です。 |
discoveryVideoResponsiveAd |
ファインド動画レスポンシブ広告に関する詳細です。 |
travelAd |
旅行の広告に関する詳細。 |
FinalAppUrl
特定のオペレーティング システムのアプリへのディープリンク用の URL。
JSON 表現 |
---|
{
"osType": enum ( |
フィールド | |
---|---|
osType |
この URL のターゲットとなるオペレーティング システム。必須。 |
url |
アプリのディープリンク URL。ディープリンクでは、表示するコンテンツに対応するアプリ内の場所を指定します。形式は {scheme}://{host_path} にする必要があります。スキームによって、開くアプリが決まります。アプリでは、アプリ名で始まるカスタム スキームを使用できます。ホストとパスは、コンテンツが存在するアプリ内の固有の場所を指定します。(例: exampleapp://productid_1234)。必須。 |
AppUrlOperatingSystemType
OS
列挙型 | |
---|---|
UNSPECIFIED |
指定されていません。 |
UNKNOWN |
戻り値にのみ使用されます。このバージョンで不明な値を表します。 |
IOS |
Apple IOS オペレーティング システム。 |
ANDROID |
Android オペレーティング システム。 |
CustomParameter
trackingUrlTemplate
、finalUrls
、mobile_final_urls
のカスタム パラメータ タグで使用できるマッピング。
JSON 表現 |
---|
{ "key": string, "value": string } |
フィールド | |
---|---|
key |
パラメータタグ名と一致するキー。 |
value |
置換される値。 |
AdType
使用可能な広告の種類。
列挙型 | |
---|---|
UNSPECIFIED |
値が指定されていません。 |
UNKNOWN |
このバージョンでは受信した値が不明です。 これはレスポンス専用の値です。 |
TEXT_AD |
テキスト広告である。 |
EXPANDED_TEXT_AD |
広告が拡張テキスト広告である。 |
EXPANDED_DYNAMIC_SEARCH_AD |
広告が拡張動的検索広告である。 |
HOTEL_AD |
広告がホテル広告である。 |
SHOPPING_SMART_AD |
スマート ショッピング広告である。 |
SHOPPING_PRODUCT_AD |
通常のショッピング広告である。 |
VIDEO_AD |
広告が動画広告である。 |
IMAGE_AD |
この広告はイメージ広告です。 |
RESPONSIVE_SEARCH_AD |
広告がレスポンシブ検索広告である。 |
LEGACY_RESPONSIVE_DISPLAY_AD |
広告が以前のレスポンシブ ディスプレイ広告である。 |
APP_AD |
アプリ広告である。 |
LEGACY_APP_INSTALL_AD |
広告が以前のアプリ インストール広告です。 |
RESPONSIVE_DISPLAY_AD |
広告がレスポンシブ ディスプレイ広告である。 |
LOCAL_AD |
広告がローカル広告である。 |
HTML5_UPLOAD_AD |
この広告は、商品カテゴリが HTML5_UPLOAD_AD のディスプレイ アップロード広告です。 |
DYNAMIC_HTML5_AD |
この広告は、いずれかの DYNAMIC_HTML5_* 商品カテゴリのディスプレイ アップロード広告です。 |
APP_ENGAGEMENT_AD |
アプリ エンゲージメント広告である。 |
SHOPPING_COMPARISON_LISTING_AD |
ショッピング比較広告である。 |
VIDEO_BUMPER_AD |
動画のバンパー広告。 |
VIDEO_NON_SKIPPABLE_IN_STREAM_AD |
スキップ不可の動画インストリーム広告です。 |
VIDEO_OUTSTREAM_AD |
アウトストリーム動画広告です。 |
VIDEO_TRUEVIEW_IN_STREAM_AD |
動画 TrueView インストリーム広告。 |
VIDEO_RESPONSIVE_AD |
動画レスポンシブ広告。 |
SMART_CAMPAIGN_AD |
スマート アシスト キャンペーン広告です。 |
CALL_AD |
電話専用広告。 |
APP_PRE_REGISTRATION_AD |
ユニバーサル アプリ事前登録広告です。 |
IN_FEED_VIDEO_AD |
インフィード動画広告。 |
DISCOVERY_MULTI_ASSET_AD |
ファインド マルチアセット広告です。 |
DISCOVERY_CAROUSEL_AD |
ファインド カルーセル広告です。 |
TRAVEL_AD |
旅行の広告。 |
DISCOVERY_VIDEO_RESPONSIVE_AD |
ファインド動画レスポンシブ広告です。 |
デバイス
ターゲティングに使用できる Google 広告のデバイスを列挙します。
列挙型 | |
---|---|
UNSPECIFIED |
指定されていません。 |
UNKNOWN |
このバージョンでは値が不明です。 |
MOBILE |
フル インターネット ブラウザ搭載のモバイル デバイス。 |
TABLET |
フル インターネット ブラウザ搭載のタブレット。 |
DESKTOP |
パソコン。 |
CONNECTED_TV |
スマートテレビとゲーム機。 |
OTHER |
その他のデバイスタイプ。 |
UrlCollection
一意の識別子でタグ付けされた URL のコレクション。
JSON 表現 |
---|
{ "finalUrls": [ string ], "finalMobileUrls": [ string ], "urlCollectionId": string, "trackingUrlTemplate": string } |
フィールド | |
---|---|
finalUrls[] |
最終ページ URL の候補のリスト。 |
finalMobileUrls[] |
有効なモバイルの最終ページ URL のリスト。 |
urlCollectionId |
この UrlCollection インスタンスの一意の識別子。 |
trackingUrlTemplate |
トラッキング URL を作成するための URL テンプレート。 |
SystemManagedResourceSource
システム管理のエンティティ ソースを列挙する列挙型。
列挙型 | |
---|---|
UNSPECIFIED |
指定されていません。 |
UNKNOWN |
戻り値にのみ使用されます。このバージョンで不明な値を表します。 |
AD_VARIATIONS |
広告バリエーションのテスト広告を生成しました。 |
TextAdInfo
テキスト広告。
JSON 表現 |
---|
{ "headline": string, "description1": string, "description2": string } |
フィールド | |
---|---|
headline |
広告の見出し。 |
description1 |
広告の説明欄の 1 行目。 |
description2 |
広告の説明欄の 2 行目。 |
ExpandedTextAdInfo
拡張テキスト広告。
JSON 表現 |
---|
{ "headlinePart1": string, "headlinePart2": string, "headlinePart3": string, "description": string, "description2": string, "path1": string, "path2": string } |
フィールド | |
---|---|
headlinePart1 |
広告見出しの最初の部分。 |
headlinePart2 |
広告見出しの 2 番目の部分。 |
headlinePart3 |
広告見出しの 3 番目の部分。 |
description |
広告の説明。 |
description2 |
広告の 2 番目の説明文。 |
path1 |
広告の表示される URL の横に表示できるテキスト。 |
path2 |
広告の表示される URL の横に表示できる追加テキスト。 |
CallAdInfo
電話専用広告。
JSON 表現 |
---|
{
"countryCode": string,
"phoneNumber": string,
"businessName": string,
"headline1": string,
"headline2": string,
"description1": string,
"description2": string,
"callTracked": boolean,
"disableCallConversion": boolean,
"phoneNumberVerificationUrl": string,
"conversionAction": string,
"conversionReportingState": enum ( |
フィールド | |
---|---|
countryCode |
広告の国コード。 |
phoneNumber |
広告内の電話番号。 |
businessName |
広告内のビジネスの名前。 |
headline1 |
広告の最初の見出し。 |
headline2 |
広告の 2 番目の見出し。 |
description1 |
広告の説明欄の 1 行目。 |
description2 |
広告の説明欄の 2 行目。 |
callTracked |
クリエイティブのコール トラッキングを有効にするかどうかを指定します。コール トラッキングを有効にすると、コール コンバージョンも有効になります。 |
disableCallConversion |
クリエイティブの通話コンバージョンを無効にするかどうかを指定します。 |
phoneNumberVerificationUrl |
電話番号の確認に使用する URL。 |
conversionAction |
通話コンバージョンを関連付けるコンバージョン アクション。設定しない場合は、デフォルトのコンバージョン アクションが使用されます。このフィールドは、 |
conversionReportingState |
この電話専用広告の通話コンバージョン動作です。独自の通話コンバージョン設定を使用することも、アカウント単位の設定を継承することも、無効にすることもできます。 |
path1 |
広告の URL に追加できるテキストの最初の部分。省略可。 |
path2 |
広告の URL に追加できるテキストの 2 番目の部分。このフィールドは、 |
CallConversionReportingState
通話コンバージョン アクションの状態で使用可能なデータタイプ。
列挙型 | |
---|---|
UNSPECIFIED |
指定されていません。 |
UNKNOWN |
戻り値にのみ使用されます。このバージョンで不明な値を表します。 |
DISABLED |
通話コンバージョン アクションが無効になっています。 |
USE_ACCOUNT_LEVEL_CALL_CONVERSION_ACTION |
通話コンバージョン アクションでは、アカウント単位で設定された通話コンバージョンの種類が使用されます。 |
USE_RESOURCE_LEVEL_CALL_CONVERSION_ACTION |
通話コンバージョン アクションでは、リソース(電話専用広告または電話番号表示オプション)単位で設定された通話コンバージョンの種類が使用されます。 |
ExpandedDynamicSearchAdInfo
拡張動的検索広告。
JSON 表現 |
---|
{ "description": string, "description2": string } |
フィールド | |
---|---|
description |
広告の説明。 |
description2 |
広告の 2 番目の説明文。 |
HotelAdInfo
このタイプにはフィールドがありません。
ホテル広告。
ShoppingSmartAdInfo
このタイプにはフィールドがありません。
スマート ショッピング広告です。
ShoppingProductAdInfo
このタイプにはフィールドがありません。
標準のショッピング広告です。
ImageAdInfo
イメージ広告。
JSON 表現 |
---|
{ "mimeType": enum ( |
フィールド | |
---|---|
mimeType |
画像の MIME タイプ。 |
pixelWidth |
フルサイズの画像の幅(ピクセル単位)。 |
pixelHeight |
フルサイズの画像の高さ(ピクセル単位)。 |
imageUrl |
フルサイズの画像の URL。 |
previewPixelWidth |
プレビュー サイズの画像の幅(ピクセル単位)。 |
previewPixelHeight |
プレビュー サイズ画像の高さ(ピクセル単位)。 |
previewImageUrl |
プレビュー サイズ画像の URL。 |
name |
画像の名前。画像が MediaFile から作成された場合は、MediaFile の名前です。画像がバイトから作成された場合、これは空です。 |
共用体フィールド image 。ImageAd の作成元の画像。これは、次の 2 つの方法のいずれかで指定できます。1. 既存の MediaFile リソース。2. 未加工の画像データ(バイト単位)。image は次のいずれかになります。 |
|
imageAsset |
広告に使用される画像アセット。 |
data |
未加工の画像データ(バイト単位)。 Base64 でエンコードされた文字列。 |
adIdToCopyImageFrom |
画像のコピー元の広告 ID。 |
MimeType
MIME タイプ
列挙型 | |
---|---|
UNSPECIFIED |
MIME タイプが指定されていません。 |
UNKNOWN |
このバージョンでは受信した値が不明です。 これはレスポンス専用の値です。 |
IMAGE_JPEG |
image/jpeg の MIME タイプ。 |
IMAGE_GIF |
画像/GIF の MIME タイプ。 |
IMAGE_PNG |
image/png の MIME タイプ。 |
FLASH |
application/x-shockwave-flash の MIME タイプ。 |
TEXT_HTML |
text/html の MIME タイプ。 |
PDF |
application/pdf の MIME タイプ。 |
MSWORD |
application/msword の MIME タイプ。 |
MSEXCEL |
application/vnd.ms-excel の MIME タイプ。 |
RTF |
application/rtf の MIME タイプ。 |
AUDIO_WAV |
音声/wav の MIME タイプ。 |
AUDIO_MP3 |
Audio/mp3 の MIME タイプ。 |
HTML5_AD_ZIP |
application/x-html5-ad-zip の MIME タイプ。 |
AdImageAsset
広告内で使用される画像アセット。
JSON 表現 |
---|
{ "asset": string } |
フィールド | |
---|---|
asset |
この画像のアセット リソース名。 |
VideoAdInfo
動画広告。
JSON 表現 |
---|
{ "video": { object ( |
フィールド | |
---|---|
video |
広告に使用された YouTube 動画アセット。 |
共用体フィールド format 。各動画形式の形式固有のスキーマ。format は次のいずれかになります。 |
|
inStream |
動画 TrueView インストリーム広告フォーマットです。 |
bumper |
動画バンパー インストリーム広告フォーマットです。 |
outStream |
動画アウトストリーム広告フォーマットです。 |
nonSkippable |
スキップ不可の動画インストリーム広告フォーマットです。 |
inFeed |
インフィード動画広告フォーマットです。 |
AdVideoAsset
広告内で使用される動画アセットです。
JSON 表現 |
---|
{ "asset": string } |
フィールド | |
---|---|
asset |
この動画のアセットのリソース名。 |
VideoTrueViewInStreamAdInfo
動画 TrueView インストリーム広告のフォーマットです(動画の再生中、多くの場合は再生中に表示され、再生されると数秒でスキップボタンが表示されます)。
JSON 表現 |
---|
{
"actionButtonLabel": string,
"actionHeadline": string,
"companionBanner": {
object ( |
フィールド | |
---|---|
actionButtonLabel |
動画広告の最終ページ URL にユーザーを誘導する行動を促すフレーズ(CTA)ボタンのラベル。TrueView アクション キャンペーンの場合は必須。それ以外の場合は省略可。 |
actionHeadline |
行動を促すフレーズ(CTA)ボタンとともに表示される追加のテキストで、コンテキストを提供し、ボタンをクリックするよう促します。 |
companionBanner |
広告で使用されるコンパニオン バナーの画像アセット。 |
VideoBumperInStreamAdInfo
動画バンパー インストリーム広告フォーマット(非常に短いスキップ不可のインストリーム動画広告)を表します。
JSON 表現 |
---|
{
"companionBanner": {
object ( |
フィールド | |
---|---|
companionBanner |
広告で使用されるコンパニオン バナーの画像アセット。 |
actionButtonLabel |
動画広告の最終ページ URL にユーザーを誘導する [行動を促すフレーズ] ボタンのラベル。 |
actionHeadline |
行動を促すフレーズ(CTA)ボタンとともに表示される追加のテキストで、コンテキストを提供し、ボタンをクリックするよう促します。 |
VideoOutstreamAdInfo
動画アウトストリーム広告フォーマット(音声なしで自動再生されるフィードの横に表示される広告)を表します。
JSON 表現 |
---|
{ "headline": string, "description": string } |
フィールド | |
---|---|
headline |
広告の見出し。 |
description |
説明文。 |
VideoNonSkippableInStreamAdInfo
スキップ不可の動画インストリーム広告フォーマット(15 秒のスキップ不可のインストリーム動画広告)を表します。
JSON 表現 |
---|
{
"companionBanner": {
object ( |
フィールド | |
---|---|
companionBanner |
広告で使用されるコンパニオン バナーの画像アセット。 |
actionButtonLabel |
動画広告の最終ページ URL にユーザーを誘導する [行動を促すフレーズ] ボタンのラベル。 |
actionHeadline |
コンテキストを示し、ボタンをクリックするよう促すために、「行動を促すフレーズ」ボタンとともに表示される追加のテキスト。 |
InFeedVideoAdInfo
インフィード動画広告フォーマットを表します。
JSON 表現 |
---|
{
"headline": string,
"description1": string,
"description2": string,
"thumbnail": enum ( |
フィールド | |
---|---|
headline |
広告の見出し。 |
description1 |
広告の 1 行目のテキスト。 |
description2 |
広告の 2 行目のテキスト。 |
thumbnail |
使用する動画のサムネイル画像。 |
VideoThumbnail
動画サムネイルで使用可能なタイプをリストした列挙型です。
列挙型 | |
---|---|
UNSPECIFIED |
タイプが指定されていません。 |
UNKNOWN |
このバージョンでは受信した値が不明です。これはレスポンス専用の値です。 |
DEFAULT_THUMBNAIL |
デフォルトのサムネイル。自動生成することも、ユーザーがアップロードすることもできます。 |
THUMBNAIL_1 |
動画から生成されたサムネイル 1。 |
THUMBNAIL_2 |
動画から生成されたサムネイル 2。 |
THUMBNAIL_3 |
動画から生成されたサムネイル 3。 |
VideoResponsiveAdInfo
動画レスポンシブ広告。
JSON 表現 |
---|
{ "headlines": [ { object ( |
フィールド | |
---|---|
headlines[] |
短い広告見出しに使用されるテキスト アセットのリスト。現在、短い広告見出しに指定できる値は 1 つのみです。 |
longHeadlines[] |
長い広告見出しに使用されるテキスト アセットのリスト。現在、長い広告見出しでサポートされている値は 1 つのみです。 |
descriptions[] |
説明文に使用されるテキスト アセットのリスト。現在、商品説明に指定できる値は 1 つのみです。 |
callToActions[] |
ボタンに使用されるテキスト アセットのリスト(「行動を促すフレーズ」ボタンなど)。現時点では、ボタンで 1 つの値のみがサポートされています。 |
videos[] |
広告に使用される YouTube 動画アセットのリスト。現在、YouTube 動画アセットでサポートされている値は 1 つのみです。 |
companionBanners[] |
コンパニオン バナーに使用する画像アセットのリストです。現在、コンパニオン バナー アセットで使用できる値は 1 つのみです。 |
breadcrumb1 |
表示 URL とともに表示される広告に表示されるテキストの最初の部分。 |
breadcrumb2 |
表示された URL とともに表示される広告に表示されるテキストの 2 番目の部分。 |
AdTextAsset
広告内で使用されるテキスト アセットです。
JSON 表現 |
---|
{ "pinnedField": enum ( |
フィールド | |
---|---|
pinnedField |
アセットの固定フィールド。これにより、アセットはこのフィールド内でのみ配信されるようになります。同じフィールドに複数のアセットを固定できます。固定されていないアセット、または別のフィールドに固定されているアセットは、他のアセットが固定されているフィールドには配信されません。 |
assetPerformanceLabel |
このテキスト アセットのパフォーマンス ラベルです。 |
policySummaryInfo |
このテキスト アセットのポリシーの概要です。 |
text |
アセットのテキスト。 |
ServedAssetFieldType
使用可能なアセット フィールドのタイプ。
列挙型 | |
---|---|
UNSPECIFIED |
値が指定されていません。 |
UNKNOWN |
このバージョンでは受信した値が不明です。 これはレスポンス専用の値です。 |
HEADLINE_1 |
アセットは広告見出し 1 で使用されています。 |
HEADLINE_2 |
アセットは広告見出し 2 で使用されています。 |
HEADLINE_3 |
アセットは広告見出し 3 で使用されています。 |
DESCRIPTION_1 |
アセットが説明文 1 で使用されている。 |
DESCRIPTION_2 |
アセットが説明文 2 で使用されている。 |
HEADLINE |
アセットが広告見出しで使用されています。広告見出しが 1 つしかない場合にのみ使用します。それ以外の場合は、HEADLINE_1、HEADLINE_2、または HEADLINE_3 の列挙型を使用します。 |
HEADLINE_IN_PORTRAIT |
このアセットは、縦向き画像の見出しとして使用されました。 |
LONG_HEADLINE |
アセットが長い広告見出し(MultiAsset レスポンシブ検索広告で使用)で使用されています。 |
DESCRIPTION |
アセットが説明で使用されました。広告内の説明文が 1 つしかない場合にのみ使用します。それ以外の場合は、DESCRIPTION_1 または DESCRIPTION_@ 列挙型を使用します。 |
DESCRIPTION_IN_PORTRAIT |
このアセットは、縦向き画像の説明として使われていました。 |
BUSINESS_NAME_IN_PORTRAIT |
このアセットは、縦向き画像のビジネス名として使用されていました。 |
BUSINESS_NAME |
アセットがビジネス名として使用されていた。 |
MARKETING_IMAGE |
アセットがマーケティング画像として使用されていた。 |
MARKETING_IMAGE_IN_PORTRAIT |
このアセットは、縦向き画像のマーケティング画像として使用されました。 |
SQUARE_MARKETING_IMAGE |
アセットはスクエアのマーケティング画像として使用されました。 |
PORTRAIT_MARKETING_IMAGE |
このアセットは、縦向きのマーケティング画像として使用されました。 |
LOGO |
アセットがロゴとして使用されていた。 |
LANDSCAPE_LOGO |
アセットが横長のロゴとして使用されていました。 |
CALL_TO_ACTION |
行動を促すフレーズとしてアセットが使用されていた。 |
YOU_TUBE_VIDEO |
アセットが YouTube 動画として使用されていた。 |
SITELINK |
このアセットはサイトリンクとして使用されています。 |
CALL |
このアセットは電話番号として使用されています。 |
MOBILE_APP |
このアセットはモバイルアプリとして使用されています。 |
CALLOUT |
このアセットはコールアウトとして使用されます。 |
STRUCTURED_SNIPPET |
このアセットは構造化スニペットとして使用されます。 |
PRICE |
このアセットは価格として使用されます。 |
PROMOTION |
このアセットはプロモーションとして使用されています。 |
AD_IMAGE |
このアセットは画像として使用されます。 |
LEAD_FORM |
アセットがリードフォームとして使用されます。 |
BUSINESS_LOGO |
アセットがビジネスのロゴとして使用されている。 |
AssetPerformanceLabel
アセットのパフォーマンス ラベルを記述する列挙型。通常はリンクのコンテキストで計算されます。
列挙型 | |
---|---|
UNSPECIFIED |
指定されていません。 |
UNKNOWN |
戻り値にのみ使用されます。このバージョンで不明な値を表します。 |
PENDING |
このアセットには、まだパフォーマンスに関する情報がありません。まだ審査中であるためです。 |
LEARNING |
アセットでインプレッションが発生していますが、統計的有意性がないためアセットのパフォーマンス ラベルを取得できません。 |
LOW |
パフォーマンスが最も低いアセット。 |
GOOD |
パフォーマンスの高いアセット。 |
BEST |
パフォーマンスが特に高いアセット。 |
AdAssetPolicySummary
広告内のアセットのポリシー情報が含まれます。
JSON 表現 |
---|
{ "policyTopicEntries": [ { object ( |
フィールド | |
---|---|
policyTopicEntries[] |
このアセットに対するポリシーの検出結果のリスト。 |
reviewStatus |
このアセットの審査プロセスのどの段階にあるか。 |
approvalStatus |
このアセットの全体的な承認ステータス。個々のポリシー トピック エントリのステータスに基づいて計算されます。 |
PolicyTopicEntry
リソースに関連付けられているポリシーの検出結果(アルコールを販売するサイトに関連付けられたアルコールに関するポリシーなど)。
各 PolicyTopicEntry には、エントリが対象とする特定の広告ポリシーを示すトピックと、エントリが配信に与える影響を示すタイプがあります。必要に応じて、検出結果の理由を示す証拠を 1 つ以上含めることができます。必要に応じて 1 つ以上の制約を設定し、配信をどのように制限するかを詳細に示すこともできます。
JSON 表現 |
---|
{ "type": enum ( |
フィールド | |
---|---|
type |
このポリシーが配信に対して与えるプラスまたはマイナスの影響を表します。 |
evidences[] |
ポリシーの検出を説明する追加情報(商標の検出結果のブランド名など)。 |
constraints[] |
このリソースの配信にどのような影響があるかを示します(特定の国で配信されないなど)。 |
topic |
この検出結果が参照するポリシー トピック。例: 「ALCOHOL」、「TRADEMARKS_IN_AD_TEXT」、「DESTINATION_NOT_WORKING」。取り得るポリシー トピックのセットは、特定の API バージョンに対して固定されておらず、いつでも変更される可能性があります。 |
PolicyTopicEntryType
ポリシー トピックの使用可能なエントリタイプ。
列挙型 | |
---|---|
UNSPECIFIED |
値が指定されていません。 |
UNKNOWN |
このバージョンでは受信した値が不明です。 これはレスポンス専用の値です。 |
PROHIBITED |
リソースは提供されません。 |
LIMITED |
リソースは、状況によって提供されません。 |
FULLY_LIMITED |
現在のターゲティング条件のため、リソースをまったく配信できません。 |
DESCRIPTIVE |
関心があるかもしれませんが、リソースの提供方法を制限するものではありません。 |
BROADENING |
通常より通信可能範囲が広がる可能性があります。 |
AREA_OF_INTEREST_ONLY |
すべてのターゲット国に限定されますが、関心対象地域を通じて他の国でも広告が配信される場合があります。 |
PolicyTopicEvidence
ポリシーの検出結果について説明する追加情報。
JSON 表現 |
---|
{ // Union field |
フィールド | |
---|---|
共用体フィールド value 。証拠のタイプに応じた具体的な証拠情報。value は次のいずれかになります。 |
|
websiteList |
このリソースにリンクされているウェブサイトのリスト。 |
textList |
リソースのテキスト内で見つかった証拠のリスト。 |
languageCode |
検出されたリソースの記述言語。これは「en-US」などの IETF 言語タグです。 |
destinationTextList |
ポリシーの検出の原因となったリソースの宛先のテキスト。 |
destinationMismatch |
リソースの URL の宛先が一致しない。 |
destinationNotWorking |
一般的に使用されるデバイスのリンク先で HTTP エラーコードが返された場合や、一部の地域で機能しない場合の詳細が表示されます。 |
WebsiteList
ポリシー検出の原因となったウェブサイトのリスト。たとえば、ONE_WEBSITE_PER_AD_GROUP ポリシー トピックに使用されます。ウェブサイトが 6 つ以上ある場合は、上位 5 つ(リソースに最も多く表示されるウェブサイト)のみがここに表示されます。
JSON 表現 |
---|
{ "websites": [ string ] } |
フィールド | |
---|---|
websites[] |
ポリシー違反の検出の原因となったウェブサイト。 |
TextList
ポリシーに違反しているテキスト フラグメントのリスト。
JSON 表現 |
---|
{ "texts": [ string ] } |
フィールド | |
---|---|
texts[] |
ポリシー検出の原因となったリソースのテキスト フラグメント。 |
DestinationTextList
リンク先ページで見つかった、ポリシー検出の原因となった文字列のリスト。
JSON 表現 |
---|
{ "destinationTexts": [ string ] } |
フィールド | |
---|---|
destinationTexts[] |
リソースのリンク先ページにあるテキストのリスト。 |
DestinationMismatch
リソースの URL 間の不一致の証拠。
JSON 表現 |
---|
{
"urlTypes": [
enum ( |
フィールド | |
---|---|
urlTypes[] |
互いに一致しない URL のセットです。 |
PolicyTopicEvidenceDestinationMismatchUrlType
ポリシートピックの証拠のリンク先の不一致の URL タイプである可能性があります。
列挙型 | |
---|---|
UNSPECIFIED |
値が指定されていません。 |
UNKNOWN |
このバージョンでは受信した値が不明です。 これはレスポンス専用の値です。 |
DISPLAY_URL |
表示 URL。 |
FINAL_URL |
最終ページ URL。 |
FINAL_MOBILE_URL |
モバイルの最終ページ URL。 |
TRACKING_URL |
パソコン用 URL に置換されたトラッキング URL テンプレート。 |
MOBILE_TRACKING_URL |
モバイル URL に置換されたトラッキング URL テンプレート。 |
DestinationNotWorking
リンク先が HTTP エラーコードを返す場合、または一般的に使用されているデバイスの一部の地域で機能しない場合の証拠の詳細。
JSON 表現 |
---|
{ "device": enum ( |
フィールド | |
---|---|
device |
URL の読み込みに失敗したデバイスの種類。 |
expandedUrl |
機能しなかった完全な URL。 |
lastCheckedDateTime |
URL が最後に確認された時刻。形式は「YYYY-MM-DD HH:MM:SS」です。例: "2018-03-05 09:15:00"、"2018-02-01 14:34:30" |
共用体フィールド reason 。DESTINATION_NOT_WORKING ポリシー検出結果の理由を示します。reason は次のいずれかになります。 |
|
dnsErrorType |
DNS エラーのタイプ。 |
httpErrorCode |
HTTP エラーコード。 |
PolicyTopicEvidenceDestinationNotWorkingDevice
可能性のあるポリシー トピックのエビデンスの宛先が機能していないデバイス。
列挙型 | |
---|---|
UNSPECIFIED |
値が指定されていません。 |
UNKNOWN |
このバージョンでは受信した値が不明です。 これはレスポンス専用の値です。 |
DESKTOP |
ランディング ページはパソコンでは機能しません。 |
ANDROID |
ランディング ページが Android デバイスで機能しません。 |
IOS |
ランディング ページが iOS デバイスで機能しません。 |
PolicyTopicEvidenceDestinationNotWorkingDnsErrorType
ポリシー トピックの証拠の宛先が機能しない DNS エラータイプ。
列挙型 | |
---|---|
UNSPECIFIED |
値が指定されていません。 |
UNKNOWN |
このバージョンでは受信した値が不明です。 これはレスポンス専用の値です。 |
HOSTNAME_NOT_FOUND |
ランディング ページの取得時に DNS でホスト名が見つかりませんでした。 |
GOOGLE_CRAWLER_DNS_ISSUE |
DNS と通信する際の Google 内部のクローラの問題。このエラーが表示されても、ランディング ページが機能していないわけではありません。Google がランディング ページを再クロールします。 |
PolicyTopicConstraint
ポリシー トピック エントリの提供に対する影響を示します。
JSON 表現 |
---|
{ // Union field |
フィールド | |
---|---|
共用体フィールド value 。制約に関する具体的な情報。value は次のいずれかになります。 |
|
countryConstraintList |
リソースを提供できない国。 |
resellerConstraint |
販売パートナーの制約。 |
certificateMissingInCountryList |
配信に証明書が必要な国です。 |
certificateDomainMismatchInCountryList |
リソースのドメインが、関連する証明書でカバーされていない国。 |
CountryConstraintList
リソースの配信が制限されている国のリスト。
JSON 表現 |
---|
{
"countries": [
{
object ( |
フィールド | |
---|---|
countries[] |
配信が制限されている国。 |
totalTargetedCountries |
リソースのターゲット国の合計数。 |
CountryConstraint
特定の国でリソースを提供する機能が制限されていることを示します。
JSON 表現 |
---|
{ "countryCriterion": string } |
フィールド | |
---|---|
countryCriterion |
配信が制限されている国の地域ターゲティングの定数リソース名。 |
ResellerConstraint
このタイプにはフィールドがありません。
再販業者向けのウェブサイトが不承認になったため、ポリシー項目が制限されたことを示します。
PolicyReviewStatus
ポリシー審査のステータス。
列挙型 | |
---|---|
UNSPECIFIED |
値が指定されていません。 |
UNKNOWN |
このバージョンでは受信した値が不明です。 これはレスポンス専用の値です。 |
REVIEW_IN_PROGRESS |
現在審査中です。 |
REVIEWED |
一次審査が完了しました。その他の審査は継続される可能性があります。 |
UNDER_APPEAL |
リソースは承認のために再送信されたか、ポリシーに関する決定に対して再審査請求が行われました。 |
ELIGIBLE_MAY_SERVE |
リソースは有効であり、配信されている可能性がありますが、さらに審査される可能性があります。 |
PolicyApprovalStatus
ポリシーの承認ステータスとして考えられるもの。承認ステータスが複数ある場合は、最も重要度の高いステータスが使用されます。重大度の順序は、DISAPPROVED、AREA_OF_INTEREST_ONLY、APPROVED_LIMITED、APPROVED です。
列挙型 | |
---|---|
UNSPECIFIED |
値が指定されていません。 |
UNKNOWN |
このバージョンでは受信した値が不明です。 これはレスポンス専用の値です。 |
DISAPPROVED |
配信されません。 |
APPROVED_LIMITED |
制限付きで配信されます。 |
APPROVED |
制限なく配信されます。 |
AREA_OF_INTEREST_ONLY |
ターゲットに設定した国では配信されませんが、対象国に関する情報を検索するユーザーには配信される可能性があります。 |
ResponsiveSearchAdInfo
レスポンシブ検索広告。
レスポンシブ検索広告では、より豊富なテキストを使って、ユーザーに関連性の高いメッセージを表示する広告を作成できます。レスポンシブ検索広告の作成時に複数の広告見出しと説明文を入力しておくと、その後 Google 広告によってさまざまな組み合わせが自動的にテストされ、掲載結果が最も高い組み合わせが使用されます。レスポンシブ検索広告では、見込み顧客の検索語句とより一致するように広告のコンテンツが調整されるため、キャンペーンのパフォーマンスが向上する可能性があります。
詳しくは、https://support.google.com/google-ads/answer/7684791 をご覧ください。
JSON 表現 |
---|
{ "headlines": [ { object ( |
フィールド | |
---|---|
headlines[] |
広告見出しのテキスト アセットのリスト。広告が配信されるときに、このリストから広告見出しが選択されます。 |
descriptions[] |
説明のテキスト アセットのリスト。広告が配信されるときに、このリストから説明文が選択されます。 |
path1 |
広告の URL に追加できるテキストの最初の部分。 |
path2 |
広告の URL に追加できるテキストの 2 番目の部分。このフィールドは、 |
LegacyResponsiveDisplayAdInfo
従来のレスポンシブ ディスプレイ広告です。Google 広告の管理画面では、このタイプの広告は「レスポンシブ広告」と表示されます。
JSON 表現 |
---|
{
"formatSetting": enum ( |
フィールド | |
---|---|
formatSetting |
広告が配信されるフォーマットを指定します。デフォルトは ALL_FORMATS です。 |
shortHeadline |
広告見出しの短いバージョン。 |
longHeadline |
広告の見出しの長いバージョン。 |
description |
広告の説明。 |
businessName |
広告内のビジネスの名前。 |
allowFlexibleColor |
柔軟な色の使用を許可する広告主の同意。true の場合、広告は必要に応じて別の色で配信されます。false の場合、広告は指定した色またはニュートラル カラーで配信されます。デフォルト値は |
accentColor |
広告のアクセント カラー(16 進数)。たとえば、白の場合は #ffffff となります。 |
mainColor |
広告のメインの色(16 進数)。たとえば、白の場合は #ffffff です。 |
callToActionText |
広告のカスタム外部リンクのテキスト。 |
logoImage |
広告で使用されるロゴ画像の MediaFile リソース名。 |
squareLogoImage |
広告で使用されるスクエアのロゴ画像の MediaFile リソース名。 |
marketingImage |
広告で使用されるマーケティング画像の MediaFile リソース名。 |
squareMarketingImage |
広告で使用されるスクエアのマーケティング画像の MediaFile リソース名。 |
pricePrefix |
価格の前にプレフィックスを付けます。例: 「同程度」。 |
promoText |
レスポンシブ広告の動的フォーマットに使用されるプロモーション テキスト。例: 「2 日以内での無料配送」 |
DisplayAdFormatSetting
ディスプレイ広告フォーマットの設定を列挙します。
列挙型 | |
---|---|
UNSPECIFIED |
指定されていません。 |
UNKNOWN |
このバージョンでは値が不明です。 |
ALL_FORMATS |
テキスト、画像、ネイティブの各フォーマットを利用できます |
NON_NATIVE |
テキストと画像の形式。 |
NATIVE |
たとえば、ネイティブ フォーマットの場合、フォーマットのレンダリングは Google ではなくパブリッシャーが管理します。 |
AppAdInfo
アプリ広告です。
JSON 表現 |
---|
{ "mandatoryAdText": { object ( |
フィールド | |
---|---|
mandatoryAdText |
必須の広告文。 |
headlines[] |
広告見出しのテキスト アセットのリスト。広告が配信されるときに、このリストから広告見出しが選択されます。 |
descriptions[] |
説明のテキスト アセットのリスト。広告が配信されるときに、このリストから説明文が選択されます。 |
images[] |
広告とともに表示できる画像アセットのリストです。 |
youtubeVideos[] |
広告と一緒に表示される YouTube 動画アセットのリスト。 |
html5MediaBundles[] |
広告で使用できるメディア バンドル アセットのリストです。 |
AdMediaBundleAsset
広告内で使用されるメディア バンドル アセットです。
JSON 表現 |
---|
{ "asset": string } |
フィールド | |
---|---|
asset |
このメディア バンドルのアセット リソース名です。 |
LegacyAppInstallAdInfo
一部のユーザーのみが使用できる従来のアプリ インストール広告です。
JSON 表現 |
---|
{
"appStore": enum ( |
フィールド | |
---|---|
appStore |
モバイルアプリを利用できるアプリストア。 |
appId |
モバイルアプリの ID。 |
headline |
広告の見出し。 |
description1 |
広告の 1 行目の説明。 |
description2 |
広告の説明文の 2 行目。 |
LegacyAppInstallAdAppStore
従来のアプリ インストール広告のアプリストアの種類です。
列挙型 | |
---|---|
UNSPECIFIED |
指定されていません。 |
UNKNOWN |
戻り値にのみ使用されます。このバージョンで不明な値を表します。 |
APPLE_APP_STORE |
Apple iTunes。 |
GOOGLE_PLAY |
Google Play。 |
WINDOWS_STORE |
Windows ストア。 |
WINDOWS_PHONE_STORE |
Windows Phone ストア。 |
CN_APP_STORE |
アプリは中国のアプリストアでホストされています。 |
ResponsiveDisplayAdInfo
レスポンシブ ディスプレイ広告。
JSON 表現 |
---|
{ "marketingImages": [ { object ( |
フィールド | |
---|---|
marketingImages[] |
広告で使用するマーケティング画像。有効な画像形式は GIF、JPEG、PNG です。最小サイズは 600x314、アスペクト比は 1.91:1(+-1%)にする必要があります。少なくとも 1 つの |
squareMarketingImages[] |
広告で使用されるスクエアのマーケティング画像。有効な画像形式は GIF、JPEG、PNG です。最小サイズは 300×300、アスペクト比は 1:1(+-1%)にする必要があります。正方形の |
logoImages[] |
広告で使用するロゴ画像。有効な画像形式は GIF、JPEG、PNG です。最小サイズは 512×128、アスペクト比は 4:1(+-1%)にする必要があります。 |
squareLogoImages[] |
広告で使用されるスクエアのロゴ画像。有効な画像形式は GIF、JPEG、PNG です。最小サイズは 128×128、アスペクト比は 1:1(+-1%)にする必要があります。 |
headlines[] |
短い形式の広告見出しです。最大で 30 文字です。広告見出しは 1 ~ 5 個指定できます。 |
longHeadline |
長いフォーマットの広告見出し(必須)。最大で 90 文字です。 |
descriptions[] |
広告用の説明文。最大で 90 文字です。広告見出しは 1 ~ 5 個指定できます。 |
youtubeVideos[] |
広告のオプションの YouTube 動画です。最大 5 本の動画を指定できます。 |
formatSetting |
広告が配信されるフォーマットを指定します。デフォルトは ALL_FORMATS です。 |
controlSpec |
さまざまなクリエイティブ コントロールの仕様。 |
businessName |
広告主またはブランドの名前。最大表示幅は 25 です。 |
mainColor |
広告のメインの色(16 進数)。たとえば、白の場合は #ffffff です。 |
accentColor |
広告のアクセント カラー(16 進数)。たとえば、白の場合は #ffffff となります。 |
allowFlexibleColor |
柔軟な色の使用を許可する広告主の同意。true の場合、広告は必要に応じて別の色で配信されます。false の場合、広告は指定した色またはニュートラル カラーで配信されます。デフォルト値は |
callToActionText |
広告のカスタム外部リンクのテキスト。最大表示幅は 30 です。 |
pricePrefix |
価格の前にプレフィックスを付けます。例: 「同程度」。 |
promoText |
レスポンシブ広告の動的フォーマットに使用されるプロモーション テキスト。例: 「2 日以内での無料配送」 |
ResponsiveDisplayAdControlSpec
レスポンシブ ディスプレイ広告の各種クリエイティブ コントロールの仕様。
JSON 表現 |
---|
{ "enableAssetEnhancements": boolean, "enableAutogenVideo": boolean } |
フィールド | |
---|---|
enableAssetEnhancements |
広告主様がアセットの改善機能を有効にしているかどうか。 |
enableAutogenVideo |
広告主が動画の自動生成機能を有効にしているかどうか。 |
LocalAdInfo
ローカル広告。
JSON 表現 |
---|
{ "headlines": [ { object ( |
フィールド | |
---|---|
headlines[] |
広告見出しのテキスト アセットのリスト。広告が配信されるときに、このリストから広告見出しが選択されます。広告見出しは 1 ~ 5 個指定する必要があります。 |
descriptions[] |
説明のテキスト アセットのリスト。広告が配信されるときに、このリストから説明文が選択されます。説明文は 1 ~ 5 個指定する必要があります。 |
callToActions[] |
行動を促すフレーズのテキスト アセットのリスト。広告が配信されるときに、このリストから行動を促すフレーズが選択されます。行動を促すフレーズは 1 ~ 5 個指定する必要があります。 |
marketingImages[] |
広告とともに表示できるマーケティング画像アセットのリストです。画像は 314×600 ピクセルまたは 320×320 ピクセルにする必要があります。画像アセットは 1 ~ 20 個指定する必要があります。 |
logoImages[] |
広告に表示できるロゴ画像アセットのリストです。画像は 128×128 ピクセル、120 KB 以下である必要があります。画像アセットは 1 ~ 5 個指定する必要があります。 |
videos[] |
広告とともに表示できる YouTube 動画アセットのリストです。動画アセットは 1 ~ 20 個指定する必要があります。 |
path1 |
広告の URL に追加できるオプション テキストの最初の部分。 |
path2 |
広告の URL に追加できるオプション テキストの 2 番目の部分。このフィールドは、 |
DisplayUploadAdInfo
一般的なタイプのディスプレイ広告です。正確な広告フォーマットは displayUploadProductType
フィールドで制御され、広告に含めるデータの種類が決まります。
JSON 表現 |
---|
{ "displayUploadProductType": enum ( |
フィールド | |
---|---|
displayUploadProductType |
この広告の商品カテゴリ。詳細については、列挙型のコメントをご覧ください。 |
共用体フィールド media_asset 。広告を構成するアセットデータ。media_asset は次のいずれかになります。 |
|
mediaBundle |
広告で使用するメディア バンドル アセットです。HTML5_UPLOAD_AD のメディア バンドルについて詳しくは、https://support.google.com/google-ads/answer/1722096 をご覧ください。動的商品カテゴリの一部であるメディア バンドルは、Google Web Designer で作成する必要がある特殊な形式を使用します。詳しくは、https://support.google.com/webdesigner/answer/7543898 をご覧ください。 |
DisplayUploadProductType
ディスプレイ アップロードの商品タイプを列挙します。
列挙型 | |
---|---|
UNSPECIFIED |
指定されていません。 |
UNKNOWN |
このバージョンでは値が不明です。 |
HTML5_UPLOAD_AD |
HTML5 アップロード広告。この商品カテゴリでは、DisplayUploadAdInfo の upload_media_bundle フィールドを設定する必要があります。 |
DYNAMIC_HTML5_EDUCATION_AD |
動的な HTML5 教育広告。この商品カテゴリでは、DisplayUploadAdInfo の upload_media_bundle フィールドを設定する必要があります。教育キャンペーンでのみ使用できます。 |
DYNAMIC_HTML5_FLIGHT_AD |
ダイナミック HTML5 フライト広告。この商品カテゴリでは、DisplayUploadAdInfo の upload_media_bundle フィールドを設定する必要があります。フライト キャンペーンでのみ使用できます。 |
DYNAMIC_HTML5_HOTEL_RENTAL_AD |
ホテルや賃貸物件の HTML5 動的広告。この商品カテゴリでは、DisplayUploadAdInfo の upload_media_bundle フィールドを設定する必要があります。ホテル キャンペーンでのみ使用できます。 |
DYNAMIC_HTML5_JOB_AD |
動的な HTML5 求人広告。この商品カテゴリでは、DisplayUploadAdInfo の upload_media_bundle フィールドを設定する必要があります。求人キャンペーンでのみ使用できます。 |
DYNAMIC_HTML5_LOCAL_AD |
動的な HTML5 ローカル広告です。この商品カテゴリでは、DisplayUploadAdInfo の upload_media_bundle フィールドを設定する必要があります。ローカル キャンペーンでのみ使用できます。 |
DYNAMIC_HTML5_REAL_ESTATE_AD |
動的 HTML5 不動産広告。この商品カテゴリでは、DisplayUploadAdInfo の upload_media_bundle フィールドを設定する必要があります。不動産キャンペーンでのみ使用できます。 |
DYNAMIC_HTML5_CUSTOM_AD |
動的な HTML5 カスタム広告です。この商品カテゴリでは、DisplayUploadAdInfo の upload_media_bundle フィールドを設定する必要があります。カスタム キャンペーンでのみ使用できます。 |
DYNAMIC_HTML5_TRAVEL_AD |
動的 HTML5 旅行広告。この商品カテゴリでは、DisplayUploadAdInfo の upload_media_bundle フィールドを設定する必要があります。旅行キャンペーンでのみ使用できます。 |
DYNAMIC_HTML5_HOTEL_AD |
動的な HTML5 ホテル広告。この商品カテゴリでは、DisplayUploadAdInfo の upload_media_bundle フィールドを設定する必要があります。ホテル キャンペーンでのみ使用できます。 |
AppEngagementAdInfo
アプリ エンゲージメント広告では、チェックイン、購入、航空券の予約など、アプリ内での特定の操作を促すテキストを作成できます。アプリ内の特定の場所にユーザーを誘導し、探しているものを簡単にすばやく見つけられるようになります。
JSON 表現 |
---|
{ "headlines": [ { object ( |
フィールド | |
---|---|
headlines[] |
広告見出しのテキスト アセットのリスト。広告が配信されるときに、このリストから広告見出しが選択されます。 |
descriptions[] |
説明のテキスト アセットのリスト。広告が配信されるときに、このリストから説明文が選択されます。 |
images[] |
広告とともに表示できる画像アセットのリストです。 |
videos[] |
広告とともに表示できる動画アセットのリストです。 |
ShoppingComparisonListingAdInfo
ショッピング比較広告です。
JSON 表現 |
---|
{ "headline": string } |
フィールド | |
---|---|
headline |
広告の見出し。このフィールドは必須です。指定できる長さは 25 ~ 45 文字です。 |
SmartCampaignAdInfo
スマート アシスト キャンペーン広告
JSON 表現 |
---|
{ "headlines": [ { object ( |
フィールド | |
---|---|
headlines[] |
テキスト アセットのリスト。各アセットは、広告配信時の広告見出しに対応します。このリストは、3 ~ 15 個のテキスト アセットで構成されています。 |
descriptions[] |
テキスト アセットのリスト。各アセットは、広告配信時の説明文に対応します。このリストは、2 ~ 4 個のテキスト アセットで構成されます。 |
AppPreRegistrationAdInfo
アプリの事前登録広告は、Google Play のアプリやゲームの掲載情報にリンクし、Google Play、YouTube(インストリームのみ)、ディスプレイ ネットワークの他のアプリやモバイルサイトに掲載できます。アプリやゲームに対するユーザーの関心を引き付け、リリース前の段階で早期にインストール ベースを構築できます。
JSON 表現 |
---|
{ "headlines": [ { object ( |
フィールド | |
---|---|
headlines[] |
広告見出しのテキスト アセットのリスト。広告が配信されるときに、このリストから広告見出しが選択されます。 |
descriptions[] |
説明のテキスト アセットのリスト。広告が配信されるときに、このリストから説明文が選択されます。 |
images[] |
広告に表示できる画像アセット ID のリストです。 |
youtubeVideos[] |
広告とともに動画を表示できる YouTube 動画アセット ID のリストです。 |
DiscoveryMultiAssetAdInfo
ファインド マルチアセット広告です。
JSON 表現 |
---|
{ "marketingImages": [ { object ( |
フィールド | |
---|---|
marketingImages[] |
広告で使用するマーケティング画像アセット。有効な画像形式は GIF、JPEG、PNG です。最小サイズは 600x314、アスペクト比は 1.91:1(+-1%)にする必要があります。spaceMarketingImages が存在しない場合は必須。 |
squareMarketingImages[] |
広告で使用するスクエアのマーケティング画像アセット。有効な画像形式は GIF、JPEG、PNG です。最小サイズは 300×300、アスペクト比は 1:1(+-1%)にする必要があります。MarketingImages が存在しない場合は必須。 |
portraitMarketingImages[] |
広告で使用する縦向きのマーケティング画像アセット。有効な画像形式は GIF、JPEG、PNG です。最小サイズは 480x600、アスペクト比は 4:5(+-1%)にする必要があります。 |
logoImages[] |
広告で使用するロゴ画像アセット。有効な画像形式は GIF、JPEG、PNG です。最小サイズは 128×128、アスペクト比は 1:1(+-1%)にする必要があります。ロゴ画像は 1 ~ 5 個指定できます。 |
headlines[] |
広告の見出しのテキスト アセット。最大表示幅は 30 です。広告見出しは 1 ~ 5 個指定できます。 |
descriptions[] |
広告の説明テキスト。最大表示幅は 90 です。説明文は 1 ~ 5 個指定できます。 |
businessName |
広告主またはブランドの名前。最大表示幅は 25 です。必須。 |
callToActionText |
行動を促すフレーズのテキスト。 |
leadFormOnly |
この広告をリードフォームとともに配信する必要があるかどうかを示すブール値オプション。 |
DiscoveryCarouselAdInfo
ファインド カルーセル広告です。
JSON 表現 |
---|
{ "businessName": string, "logoImage": { object ( |
フィールド | |
---|---|
businessName |
必須。広告主またはブランドの名前。 |
logoImage |
必須。広告で使用するロゴ画像。最小サイズは 128×128、アスペクト比は 1:1(+-1%)にする必要があります。 |
headline |
必須。広告のタイトルです。 |
description |
必須。広告の説明テキスト。 |
callToActionText |
行動を促すフレーズのテキスト。 |
carouselCards[] |
必須。広告とともに表示されるカルーセル カード。(最小 2 個、最大 10 個)。 |
AdDiscoveryCarouselCardAsset
広告内で使用するファインド カルーセル カード アセット。
JSON 表現 |
---|
{ "asset": string } |
フィールド | |
---|---|
asset |
このファインド カルーセル カードのアセットのリソース名。 |
DiscoveryVideoResponsiveAdInfo
ファインド動画レスポンシブ広告。
JSON 表現 |
---|
{ "headlines": [ { object ( |
フィールド | |
---|---|
headlines[] |
短い広告見出しに使用されるテキスト アセットのリスト。 |
longHeadlines[] |
長い広告見出しに使用されるテキスト アセットのリスト。 |
descriptions[] |
説明文に使用されるテキスト アセットのリスト。 |
videos[] |
広告に使用される YouTube 動画アセットのリスト。 |
logoImages[] |
広告で使用するロゴ画像。有効な画像形式は GIF、JPEG、PNG です。最小サイズは 128×128、アスペクト比は 1:1(+-1%)にする必要があります。 |
breadcrumb1 |
表示 URL とともに表示される広告に表示されるテキストの最初の部分。 |
breadcrumb2 |
表示された URL とともに表示される広告に表示されるテキストの 2 番目の部分。 |
businessName |
必須。広告主またはブランドの名前。 |
callToActions[] |
[行動を促すフレーズ] ボタンに使用される CallToActionAsset タイプのアセット。 |
AdCallToActionAsset
広告内で使用する行動を促すフレーズのアセット。
JSON 表現 |
---|
{ "asset": string } |
フィールド | |
---|---|
asset |
この行動を促すフレーズのアセットのアセットのリソース名。 |
TravelAdInfo
このタイプにはフィールドがありません。
旅行の広告。
Methods |
|
---|---|
|
リクエストされた広告の詳細を返します。 |
|
広告を更新します。 |