ExpandedTextAd

拡張テキスト広告の管理に使う方法を含みます。

このオブジェクトは Ad オブジェクトから派生します。メソッドの一覧には、継承可能なすべてのメソッドが含まれます。

注:

拡張テキスト広告を、2023 年 2 月 1 日までにレスポンシブ検索広告にアップグレードしてください。この日付を過ぎると、拡張テキスト広告を新規作成したり、編集したりできなくなります。詳細については、「レスポンシブ検索広告について」を参照してください。
既存の拡張テキスト広告の配信は続けられ、またそのパフォーマンスレポートも表示されます。
拡張テキスト広告は引き続き一時停止、有効化、削除可能です。それ以外の場合、拡張テキスト広告を追加または更新しようとすると、 CampaignServiceAdTypeInvalid エラーになります。
この変更の詳細については、こちらをご覧ください。

メソッド

メソッド名	戻り値の型	説明	継承
applyLabel(string name)	void	この広告にラベルを適用します。	不要
asType	AdViewSpace	この広告を特定の広告タイプにキャストするために使用されるメソッドが含まれます。	はい
enable	void	この広告を有効にします。	はい
getAdGroup	AdGroup	この広告が属する広告グループを取得します。	はい
getCampaign	Campaign	この広告が属するキャンペーンを取得します。	はい
getDescription	string	この広告の最初の説明文を取得します。このメソッドは、 getDescription1 のため非推奨になりました。	はい
getDescription1	string	この広告の最初の説明文を取得します。このメソッドは、 getDescription と同じ値を返します。	不要
getDescription2	string	この広告の 2 つ目の説明文を取得します。	不要
getEntityType	string	このエンティティの型を取得します。	はい
getHeadlinePart1	string	この広告のタイトルの最初の部分を取得します。	不要
getHeadlinePart2	string	この広告タイトルの 2 番目の部分を取得します。	不要
getHeadlinePart3	string	この広告のタイトルの 3 番目の部分を取得します。	不要
getId	string	広告を一意に識別する ID を取得します。	はい
getPath1	string	この広告の表示 URL に追加される任意の 1 つ目のパスを取得します。	不要
getPath2	string	この広告の表示 URL に追加される 2 つ目のパス (オプション) を取得します。	不要
getPolicyApprovalStatus	string	この広告の編集承認ステータスを取得します。	はい
getStats	統計情報	この広告のパフォーマンスデータを取得します。	はい
getType	string	この広告の派生タイプを取得します。	はい
isEnabled	ブール値	この広告が有効かどうかを示すブール値を取得します。	はい
isPaused	ブール型	この広告が一時停止されているかどうかを示すブール値を取得します。	はい
isType	AdTypeSpace	広告が指定した種類であるかどうかのテストに使用されるメソッドが含まれます。	はい
labels	LabelSelector	この広告に関連付けられているラベルのリストをフィルター処理するために使用されるセレクターを取得します。	不要
一時停止	void	この広告を一時停止します。	はい
remove	void	この広告を削除します。	はい
removeLabel(string name)	void	この広告からラベルを削除します。	不要
urls	AdUrls	この広告の最終ページ URL、トラッキングテンプレート、カスタムパラメーターを取得するために使用されるメソッドが含まれます。	はい

applyLabel(string name)

広告にラベルを適用します。

広告には最大 50 個のラベルを適用できます。エンティティにラベルを追加する例については、「ラベルの使用」を参照してください。

引数

名前	型	説明
name	string	ラベルの大文字と小文字を区別する名前。適用できるこのアカウントのラベルの一覧を取得するには、 AdsApp.labels を参照してください。

戻り値

型	説明
void	Nothing を返します。

asType

この広告を特定の広告タイプにキャストするために使用されるメソッドが含まれます。

戻り値

型	説明
AdViewSpace	この広告を特定の広告タイプにキャストするために使用されるメソッドが含まれます。

enable

この広告を有効にします。 (継承)

戻り値

型	説明
void	Nothing を返します。

getAdGroup

この広告が属する広告グループを取得します。

戻り値

型	説明
AdGroup	この広告が属する広告グループ。

getCampaign

この広告が属するキャンペーンを取得します。

戻り値

型	説明
Campaign	この広告が属するキャンペーン。

getDescription

この広告の最初の説明文を取得します。このメソッドは、 getDescription1 のため非推奨になりました。

戻り値

型	説明
string	広告の最初の説明文。

getDescription1

この広告の最初の説明文を取得します。このメソッドは、 getDescription と同じ値を返します。

戻り値

型	説明
string	広告の最初の説明文。

getDescription2

この広告の 2 つ目の説明文を取得します。

戻り値

型	説明
string	広告の 2 つ目の説明文。

getEntityType

このエンティティの型を取得します。

戻り値

型	説明
string	このエンティティの種類 ( 広告) です。

getHeadlinePart1

この広告のタイトルの最初の部分を取得します。

戻り値

型	説明
string	この広告タイトルの最初の部分。

getHeadlinePart2

この広告タイトルの 2 番目の部分を取得します。

戻り値

型	説明
string	この広告タイトルの 2 番目の部分。

getHeadlinePart3

この広告のタイトルの 3 番目の部分を取得します。

戻り値

型	説明
string	この広告タイトルの 3 番目の部分。

getId

広告を一意に識別する ID を取得します。

戻り値

型	説明
string	広告を一意に識別する ID。

getPath1

この広告の表示 URL に追加される任意の 1 つ目のパスを取得します。

戻り値

型	説明
string	この広告の表示 URL に追加される最初のパス。

getPath2

この広告の表示 URL に追加される 2 つ目のパス (オプション) を取得します。

戻り値

型	説明
string	この広告の表示 URL に追加される 2 つ目のパス。

getPolicyApprovalStatus

この広告の編集承認ステータスを取得します。

戻り値

型	説明
string	広告の編集承認状態。使用可能な値は次のとおりです。 APPROVED APPROVED_LIMITED UNDER_REVIEW 不承認

getStats

この広告のパフォーマンスデータを取得します。

このメソッドを呼び出すには、広告セレクターのチェーンにいずれかのforDateRangeメソッドを含める必要があります。

戻り値

型	説明
統計情報	広告のパフォーマンスデータ。

getType

この広告の派生タイプを取得します。

戻り値

型	説明
string	この広告の派生タイプ。使用可能な種類を次に示します。 EXPANDED_TEXT_AD .

isEnabled

この広告が有効かどうかを示すブール値を取得します。

戻り値

型	説明
ブール値	この広告が有効な場合は true 。それ以外の場合は false。

isPaused

この広告が一時停止されているかどうかを示すブール値を取得します。

戻り値

型	説明
ブール型	この広告が一時停止の場合は true 。それ以外の場合は false。

isType

広告が指定した種類であるかどうかのテストに使用されるメソッドが含まれます。

戻り値

型	説明
AdTypeSpace	広告が指定した種類であるかどうかのテストに使用されるメソッドが含まれます。

labels

この広告に関連付けられているラベルのリストをフィルター処理するために使用されるセレクターを取得します。

戻り値

型	説明
LabelSelector	この広告に関連付けられているラベルのリストをフィルター処理するために使用されるセレクター。

一時停止

この広告を一時停止します。

戻り値

型	説明
void	Nothing を返します。

remove

この広告を削除します。

戻り値

型	説明
void	Nothing を返します。

removeLabel(string name)

広告からラベルを削除します。

引数

名前	型	説明
name	string	ラベルの大文字と小文字を区別する名前。この広告に関連付けられているラベルの一覧を取得するには、「ラベル」を参照してください。

戻り値

型	説明
void	Nothing を返します。

urls

この広告の最終ページ URL、トラッキングテンプレート、カスタムパラメーターを取得するために使用されるメソッドが含まれます。

戻り値

型	説明
AdUrls	この広告の最終ページ URL、トラッキングテンプレート、カスタムパラメーターを取得するために使用されるオブジェクト。

フィードバック

このページはお役に立ちましたか?

Last updated on 2026-09-11