ExpandedTextAd
拡張テキスト広告の管理に使用されるメソッドが含まれます。
このオブジェクトは 、Ad オブジェクトから派生します。 メソッドの一覧には、該当するすべての継承メソッドが含まれています。
注:
- 拡張テキスト広告を、2023 年 2 月 1 日までにレスポンシブ検索広告にアップグレードします。 この日付を過ぎると、新しいテキスト広告を作成したり、既存の拡張テキスト広告を編集したりできなくなります。 詳細については、「 レスポンシブ検索広告について」を参照してください。
- 既存の拡張テキスト広告は引き続き配信され、そのパフォーマンスに関するレポートを表示できます。
- 拡張テキスト広告は引き続き一時停止、有効化、または削除できます。 そうしないと、拡張テキスト広告を追加または更新しようとすると、エラーが発生
CampaignServiceAdTypeInvalid
します。 - この変更の詳細については、こちらをご覧ください。
メソッド
メソッド名 | 戻り値の型 | 説明 | 継承 |
---|---|---|---|
applyLabel(string name) | void | この広告にラベルを適用します。 | 不要 |
asType | AdViewSpace | この広告を特定の広告の種類にキャストするために使用されるメソッドが含まれています。 | はい |
有効 | void | この広告を有効にします。 | はい |
getAdGroup | AdGroup | この広告が属する広告グループを取得します。 | はい |
getCampaign | キャンペーン | この広告が属するキャンペーンを取得します。 | はい |
getDescription | string | この広告の最初の説明を取得します。 このメソッドは 、getDescription1 を優先して非推奨になっています。 | はい |
getDescription1 | string | この広告の最初の説明を取得します。 このメソッドは 、getDescription と同じ値を返します。 | 不要 |
getDescription2 | string | この広告の 2 番目の説明を取得します。 | 不要 |
getEntityType | string | このエンティティの型を取得します。 | はい |
getHeadlinePart1 | string | この広告のタイトルの最初の部分を取得します。 | 不要 |
getHeadlinePart2 | string | この広告のタイトルの 2 番目の部分を取得します。 | 不要 |
getHeadlinePart3 | string | この広告のタイトルの 3 番目の部分を取得します。 | 不要 |
getId | 文字列 | この広告を一意に識別する ID を取得します。 | はい |
getPath1 | string | この広告の表示 URL に追加される省略可能な最初のパスを取得します。 | 不要 |
getPath2 | 文字列 | この広告の表示 URL に追加される省略可能な 2 番目のパスを取得します。 | 不要 |
getPolicyApprovalStatus | 文字列 | この広告の編集承認状態を取得します。 | はい |
getStats | 統計 | この広告のパフォーマンス データを取得します。 | はい |
Gettype | 文字列 | この広告の派生型を取得します。 | はい |
Isenabled | ブール値 | この広告が有効かどうかを示すブール値を取得します。 | はい |
isPaused | ブール型 | この広告が一時停止されているかどうかを示すブール値を取得します。 | はい |
isType | AdTypeSpace | 広告が指定した種類であるかどうかをテストするために使用されるメソッドが含まれます。 | はい |
ラベル | LabelSelector | この広告に関連付けられているラベルの一覧をフィルター処理するために使用する セレクター を取得します。 | 不要 |
一時 停止 | void | この広告を一時停止します。 | はい |
remove | void | この広告を削除します。 | はい |
removeLabel(string name) | void | この広告からラベルを削除します。 | 不要 |
Url | AdUrls | この広告の最終的な URL、追跡テンプレート、カスタム パラメーターを取得するために使用されるメソッドが含まれています。 | はい |
applyLabel(string name)
ラベルを広告に適用します。
広告には最大 50 個のラベルを適用できます。 エンティティにラベルを追加する例については、「 ラベルの使用」を参照してください。
引数
名前 | 型 | 説明 |
---|---|---|
name | string | ラベルの大文字と小文字を区別する名前。 このアカウントで適用できるラベルの一覧を取得するには、「 AdsApp.labels」を参照してください。 |
戻り値
型 | 説明 |
---|---|
void | Nothing を返します。 |
asType
この広告を特定の広告の種類にキャストするために使用されるメソッドが含まれています。
戻り値
型 | 説明 |
---|---|
AdViewSpace | この広告を特定の広告の種類にキャストするために使用されるメソッドが含まれています。 |
有効
この広告を有効にします。 (継承)
戻り値
型 | 説明 |
---|---|
void | Nothing を返します。 |
getAdGroup
この広告が属する広告グループを取得します。
戻り値
型 | 説明 |
---|---|
AdGroup | この広告が属する広告グループ。 |
getCampaign
この広告が属するキャンペーンを取得します。
戻り値
型 | 説明 |
---|---|
キャンペーン | この広告が属するキャンペーン。 |
getDescription
この広告の最初の説明を取得します。 このメソッドは 、getDescription1 を優先して非推奨になっています。
戻り値
型 | 説明 |
---|---|
string | 広告の最初の説明。 |
getDescription1
この広告の最初の説明を取得します。 このメソッドは 、getDescription と同じ値を返します。
戻り値
型 | 説明 |
---|---|
string | 広告の最初の説明。 |
getDescription2
この広告の 2 番目の説明を取得します。
戻り値
型 | 説明 |
---|---|
string | 広告の 2 番目の説明。 |
getEntityType
このエンティティの型を取得します。
戻り値
型 | 説明 |
---|---|
string | このエンティティの種類 。 これは Ad です。 |
getHeadlinePart1
この広告のタイトルの最初の部分を取得します。
戻り値
型 | 説明 |
---|---|
string | この広告のタイトルの最初の部分。 |
getHeadlinePart2
この広告のタイトルの 2 番目の部分を取得します。
戻り値
型 | 説明 |
---|---|
string | この広告のタイトルの 2 番目の部分。 |
getHeadlinePart3
この広告のタイトルの 3 番目の部分を取得します。
戻り値
型 | 説明 |
---|---|
string | この広告のタイトルの 3 番目の部分。 |
getId
この広告を一意に識別する ID を取得します。
戻り値
型 | 説明 |
---|---|
string | この広告を一意に識別する ID。 |
getPath1
この広告の表示 URL に追加される省略可能な最初のパスを取得します。
戻り値
型 | 説明 |
---|---|
string | この広告の表示 URL に追加される最初のパス。 |
getPath2
この広告の表示 URL に追加される省略可能な 2 番目のパスを取得します。
戻り値
型 | 説明 |
---|---|
string | この広告の表示 URL に追加される 2 番目のパス。 |
getPolicyApprovalStatus
この広告の編集承認状態を取得します。
戻り値
型 | 説明 |
---|---|
string | 広告の編集承認の状態。 使用可能な値を次に示します。
|
getStats
この広告のパフォーマンス データを取得します。
このメソッドを呼び出すには、広告セレクターのforDateRange
チェーンにいずれかのメソッドを含める必要があります。
戻り値
型 | 説明 |
---|---|
統計 | 広告のパフォーマンス データ。 |
Gettype
この広告の派生型を取得します。
戻り値
型 | 説明 |
---|---|
string | この広告の派生型。 可能な型を次に示します。
|
isEnabled
この広告が有効かどうかを示すブール値を取得します。
戻り値
型 | 説明 |
---|---|
ブール値 | この広告が有効になっている場合は true です。それ以外の場合は false。 |
isPaused
この広告が一時停止されているかどうかを示すブール値を取得します。
戻り値
型 | 説明 |
---|---|
ブール型 | この広告が一時停止されている場合は true です。それ以外の場合は false。 |
isType
広告が指定した種類であるかどうかをテストするために使用されるメソッドが含まれます。
戻り値
型 | 説明 |
---|---|
AdTypeSpace | 広告が指定した種類であるかどうかをテストするために使用されるメソッドが含まれます。 |
ラベル
この広告に関連付けられているラベルの一覧をフィルター処理するために使用する セレクター を取得します。
戻り値
型 | 説明 |
---|---|
LabelSelector | この広告に関連付けられているラベルの一覧をフィルター処理するために使用されるセレクター。 |
一時 停止
この広告を一時停止します。
戻り値
型 | 説明 |
---|---|
void | Nothing を返します。 |
削除
この広告を削除します。
戻り値
型 | 説明 |
---|---|
void | Nothing を返します。 |
removeLabel(string name)
広告からラベルを削除します。
引数
名前 | 型 | 説明 |
---|---|---|
name | string | ラベルの大文字と小文字を区別する名前。 この広告に関連付けられているラベルの一覧を取得するには、「 ラベル」を参照してください。 |
戻り値
型 | 説明 |
---|---|
void | Nothing を返します。 |
urls
この広告の最終的な URL、追跡テンプレート、カスタム パラメーターを取得するために使用されるメソッドが含まれています。
戻り値
型 | 説明 |
---|---|
AdUrls | この広告の最終的な URL、追跡テンプレート、およびカスタム パラメーターを取得するために使用されるオブジェクト。 |