FeedItem

フィード アイテム。

JSON 表現
{
  "resourceName": string,
  "attributeValues": [
    {
      object (FeedItemAttributeValue)
    }
  ],
  "geoTargetingRestriction": enum (GeoTargetingRestriction),
  "urlCustomParameters": [
    {
      object (CustomParameter)
    }
  ],
  "status": enum (FeedItemStatus),
  "policyInfos": [
    {
      object (FeedItemPlaceholderPolicyInfo)
    }
  ],
  "feed": string,
  "id": string,
  "startDateTime": string,
  "endDateTime": string
}
フィールド
resourceName

string

変更不可。フィード アイテムのリソース名。フィード アイテムのリソース名の形式は次のとおりです。

customers/{customerId}/feedItems/{feedId}~{feed_item_id}

attributeValues[]

object (FeedItemAttributeValue)

フィード アイテムの属性値。

geoTargetingRestriction

enum (GeoTargetingRestriction)

地域ターゲティングの制限では、ターゲティングに使用できる地域のタイプを指定します。

urlCustomParameters[]

object (CustomParameter)

trackingUrlTemplatefinalUrlsmobile_final_urls でカスタム パラメータ タグを置き換えるために使用されるマッピングのリスト。

status

enum (FeedItemStatus)

出力のみ。フィード アイテムのステータスです。このフィールドは読み取り専用です。

policyInfos[]

object (FeedItemPlaceholderPolicyInfo)

出力のみ。有効なフィード マッピングに対するフィード アイテムの検証状態と承認状態に関する情報のリスト。リストには、フィードに関連付けられたフィード マッピングの種類ごとにエントリがあります。たとえば、サイトリンクを含むフィードと電話番号フィードのマッピングを使用すると、そのフィードに関連付けられているすべてのフィード アイテムがサイトリンクと通話の両方のエントリをこのリストに含まれることになります。このフィールドは読み取り専用です。

feed

string

変更不可。このフィード アイテムが属するフィードです。

id

string (int64 format)

出力のみ。このフィード アイテムの ID。

startDateTime

string

このフィード アイテムが有効で配信を開始できる開始時間。時刻はお客様のタイムゾーンが使用されます。形式は「YYYY-MM-DD HH:MM:SS」です。例: "2018-03-05 09:15:00"、"2018-02-01 14:34:30"

endDateTime

string

このフィード アイテムが無効になり、配信が終了する終了時間。時刻はお客様のタイムゾーンが使用されます。形式は「YYYY-MM-DD HH:MM:SS」です。例: "2018-03-05 09:15:00"、"2018-02-01 14:34:30"

FeedItemAttributeValue

フィード アイテムの属性値。

JSON 表現
{
  "priceValue": {
    object (Money)
  },
  "integerValues": [
    string
  ],
  "booleanValues": [
    boolean
  ],
  "stringValues": [
    string
  ],
  "doubleValues": [
    number
  ],
  "feedAttributeId": string,
  "integerValue": string,
  "booleanValue": boolean,
  "stringValue": string,
  "doubleValue": number
}
フィールド
priceValue

object (Money)

価格の値。FeedAttributeId が PRICE タイプのフィード属性を参照している場合は、設定する必要があります。

integerValues[]

string (int64 format)

繰り返される int64 値。FeedAttributeId が INT64_LIST タイプのフィード属性を参照している場合は、設定する必要があります。

booleanValues[]

boolean

繰り返されるブール値。FeedAttributeId が BOOLEAN_LIST タイプのフィード属性を参照している場合は、設定する必要があります。

stringValues[]

string

繰り返される文字列値。FeedAttributeId が STRING_LIST、URL_LIST、DATE_TIME_LIST 型のフィード属性を参照している場合は、設定する必要があります。STRING_LIST と URL_LIST では、リストの合計サイズ(バイト単位)が 3,000 を超えないようにする必要があります。DATE_TIME_LIST では、要素の数は 200 以下にする必要があります。

STRING_LIST の場合、各文字列要素の最大長は 1,500 文字です。URL_LIST の最大長は 2,076 文字です。DATE_TIME では、文字列の形式をフィード アイテムの開始時刻および終了時刻と同じにする必要があります。

doubleValues[]

number

繰り返される倍精度値。FeedAttributeId が DOUBLE_LIST タイプのフィード属性を参照している場合は、設定する必要があります。

feedAttributeId

string (int64 format)

値が関連付けられているフィード属性の ID。

integerValue

string (int64 format)

Int64 値。FeedAttributeId が INT64 タイプのフィード属性を参照している場合は、設定する必要があります。

booleanValue

boolean

ブール値。FeedAttributeId が BOOLEAN タイプのフィード属性を参照している場合は、設定する必要があります。

stringValue

string

文字列値。FeedAttributeId が STRING、URL、DATE_TIME 型のフィード属性を参照している場合は、設定する必要があります。STRING の最大長は 1,500 文字です。URL の最大長は 2,076 文字です。DATE_TIME は、文字列を「YYYYMMDD HHMMSS」の形式にする必要があります。

doubleValue

number

倍精度値。FeedAttributeId が DOUBLE タイプのフィード属性を参照している場合は、設定する必要があります。

GeoTargetingRestriction

リクエスト コンテキストの地域が一致するかどうかを決定するために使用される制限。

列挙型
UNSPECIFIED 指定されていません。
UNKNOWN 戻り値にのみ使用されます。このバージョンで不明な値を表します。
LOCATION_OF_PRESENCE リクエスト コンテキストがユーザーの物理的な場所と一致する必要があることを示します。

FeedItemPlaceholderPolicyInfo

指定したプレースホルダ タイプのフィード アイテムに関するポリシー、検証、品質承認情報。

JSON 表現
{
  "placeholderTypeEnum": enum (PlaceholderType),
  "reviewStatus": enum (PolicyReviewStatus),
  "approvalStatus": enum (PolicyApprovalStatus),
  "policyTopicEntries": [
    {
      object (PolicyTopicEntry)
    }
  ],
  "validationStatus": enum (FeedItemValidationStatus),
  "validationErrors": [
    {
      object (FeedItemValidationError)
    }
  ],
  "qualityApprovalStatus": enum (FeedItemQualityApprovalStatus),
  "qualityDisapprovalReasons": [
    enum (FeedItemQualityDisapprovalReason)
  ],
  "feedMappingResourceName": string
}
フィールド
placeholderTypeEnum

enum (PlaceholderType)

出力のみ。プレースホルダのタイプ。

reviewStatus

enum (PolicyReviewStatus)

出力のみ。プレースホルダ タイプが審査プロセスのどの段階にあるか。

approvalStatus

enum (PolicyApprovalStatus)

出力のみ。プレースホルダ タイプの全体的な承認ステータス。個々のポリシー トピック エントリのステータスに基づいて計算されます。

policyTopicEntries[]

object (PolicyTopicEntry)

出力のみ。プレースホルダ タイプに対するポリシーの検出結果のリスト。

validationStatus

enum (FeedItemValidationStatus)

出力のみ。プレースホルダ タイプの検証ステータス。

validationErrors[]

object (FeedItemValidationError)

出力のみ。プレースホルダ タイプの検証エラーのリスト。

qualityApprovalStatus

enum (FeedItemQualityApprovalStatus)

出力のみ。プレースホルダ タイプの品質評価の承認ステータス。

qualityDisapprovalReasons[]

enum (FeedItemQualityDisapprovalReason)

出力のみ。プレースホルダ タイプの品質評価が不承認となった理由のリスト。

feedMappingResourceName

string

出力のみ。プレースホルダ タイプを含む FeedMapping です。

FeedItemValidationStatus

フィード アイテムの検証ステータス。

列挙型
UNSPECIFIED 値が指定されていません。
UNKNOWN 戻り値にのみ使用されます。このバージョンで不明な値を表します。
PENDING 検証は保留中です。
INVALID エラーが発生しました。
VALID フィード アイテムが意味的に正しい形式である。

FeedItemValidationError

検証エラーと、不適切なフィード属性のセット(これらが組み合わさってフィード アイテムの検証エラーの原因となるもの)を保存します。

JSON 表現
{
  "validationError": enum (FeedItemValidationError),
  "feedAttributeIds": [
    string
  ],
  "description": string,
  "extraInfo": string
}
フィールド
validationError

enum (FeedItemValidationError)

出力のみ。トリガーされた検証エラーを示すエラーコード。エラーの説明は [説明] フィールドで確認できます。

feedAttributeIds[]

string (int64 format)

出力のみ。検証中にフラグが付けられたフィード アイテムのフィード属性。空の場合、特定のフィード属性をエラーに関連付けることはできません(例: フィード アイテム全体のエラー)。

description

string

出力のみ。検証エラーの説明。

extraInfo

string

出力のみ。validationError と feedAttributeId で取得されない、このエラーに関連する追加情報(例:feedAttributeId がマッピングされていない場合のプレースホルダ フィールド ID)。extraInfo はローカライズされていないことに注意してください。

FeedItemValidationError

フィード アイテムの検証エラーとなる可能性があります。

列挙型
UNSPECIFIED 値が指定されていません。
UNKNOWN 戻り値にのみ使用されます。このバージョンで不明な値を表します。
STRING_TOO_SHORT 文字列が短すぎます。
STRING_TOO_LONG 文字列が長すぎます。
VALUE_NOT_SPECIFIED 値が入力されていません。
INVALID_DOMESTIC_PHONE_NUMBER_FORMAT この電話番号の形式が無効です。
INVALID_PHONE_NUMBER 文字列が電話番号を表していません。
PHONE_NUMBER_NOT_SUPPORTED_FOR_COUNTRY この電話番号の形式は国コードに対応していません。
PREMIUM_RATE_NUMBER_NOT_ALLOWED 追加料金のかかる電話番号は使用できません。
DISALLOWED_NUMBER_TYPE 許可されていない電話番号タイプです。
VALUE_OUT_OF_RANGE 指定した値が有効な範囲外です。
CALLTRACKING_NOT_SUPPORTED_FOR_COUNTRY コール トラッキングは、選択した国ではサポートされていません。
CUSTOMER_NOT_IN_ALLOWLIST_FOR_CALLTRACKING お客様はコール トラッキングの許可リストに登録されていません。
INVALID_COUNTRY_CODE 国コードが無効です。
INVALID_APP_ID 指定したモバイルアプリ ID は無効です。
MISSING_ATTRIBUTES_FOR_FIELDS 一部の必須フィールド属性が指定されていません。
INVALID_TYPE_ID メール拡張機能のメールボタン タイプが無効です。
INVALID_EMAIL_ADDRESS メールアドレスが無効です。
INVALID_HTTPS_URL メール拡張機能の HTTPS URL が無効です。
MISSING_DELIVERY_ADDRESS メール拡張機能に配送先住所がありません。
START_DATE_AFTER_END_DATE FeedItem のスケジュールの開始日が終了日より後です。
MISSING_FEED_ITEM_START_TIME FeedItem のスケジュール設定の開始時間を指定してください。
MISSING_FEED_ITEM_END_TIME FeedItem のスケジュール設定の終了時間がありません。
MISSING_FEED_ITEM_ID FeedItemId のない FeedItem ではシステム属性を計算できません。
VANITY_PHONE_NUMBER_NOT_ALLOWED 電話番号表示オプションのバニティ電話番号はサポートされていません。
INVALID_REVIEW_EXTENSION_SNIPPET レビュー テキストが無効です。
INVALID_NUMBER_FORMAT 広告パラメータの数値の形式が無効です。
INVALID_DATE_FORMAT 広告パラメータの日付の値の形式が無効です。
INVALID_PRICE_FORMAT 広告パラメータの価格の形式が無効です。
UNKNOWN_PLACEHOLDER_FIELD 広告パラメータの値に認識できないタイプが指定されています。
REVIEW_EXTENSION_SOURCE_INELIGIBLE レビュー ソースが利用できません。
HYPHENS_IN_REVIEW_EXTENSION_SNIPPET レビュー テキストにハイフンやダッシュを含めることはできません。
DOUBLE_QUOTES_IN_REVIEW_EXTENSION_SNIPPET レビュー テキストに二重引用符を含めることはできません。
QUOTES_IN_REVIEW_EXTENSION_SNIPPET レビュー テキストに引用符を含めることはできません。
INVALID_FORM_ENCODED_PARAMS パラメータが誤った形式でエンコードされています。
INVALID_URL_PARAMETER_NAME URL パラメータ名に使用できるのは、英数字、アンダースコア、ダッシュのみです。
NO_GEOCODING_RESULT 住所が見つかりません。
SOURCE_NAME_IN_REVIEW_EXTENSION_TEXT レビュー表示オプションのテキストにソース名が含まれています。
CARRIER_SPECIFIC_SHORT_NUMBER_NOT_ALLOWED 一部の電話番号は通常より短い場合があります。こうした短い数字の一部は携帯通信会社固有のものであり、すべてのユーザーが利用できるわけではないため、広告表示オプションでこうした番号を使用することはできません。
INVALID_PLACEHOLDER_FIELD_ID リクエストで存在しないプレースホルダ フィールド ID が参照されるとトリガーされます。
INVALID_URL_TAG URL に無効な ValueTrack タグまたは形式が含まれています。
LIST_TOO_LONG 指定されたリストが許容されるサイズを超えています。
INVALID_ATTRIBUTES_COMBINATION 属性の組み合わせによっては、同じフィード アイテムに指定できないことがあります。
DUPLICATE_VALUES 属性に同じ値が繰り返し指定されています。
INVALID_CALL_CONVERSION_ACTION_ID コンバージョン アクションと電話番号をリンクして、その電話番号に転送された通話時間が長すぎる場合に、指定したタイプのコンバージョンとしてカウントする必要があることを示すことができます。これは、指定されたコンバージョン アクションが無効であることを示すエラー メッセージです(例: 該当する Google 広告アカウント内にそのコンバージョン アクションが存在しない、または通話コンバージョンに適さない種類のコンバージョン)。
CANNOT_SET_WITHOUT_FINAL_URLS トラッキング テンプレートには最終ページ URL を設定する必要があります。
APP_ID_DOESNT_EXIST_IN_APP_STORE 指定されたアプリストアに存在しないアプリ ID が指定されています。
INVALID_FINAL_URL U2 の最終ページ URL が無効です。
INVALID_TRACKING_URL U2 のトラッキング URL が無効です。
INVALID_FINAL_URL_FOR_APP_DOWNLOAD_URL 最終ページ URL はアプリのダウンロード URL で始まる必要があります。
LIST_TOO_SHORT 指定されたリストは短すぎます。
INVALID_USER_ACTION ユーザーの操作フィールドに無効な値が指定されている。
INVALID_TYPE_NAME タイプフィールドに無効な値があります。
INVALID_EVENT_CHANGE_STATUS イベントの変更ステータスが無効です。
INVALID_SNIPPETS_HEADER 構造化スニペット表示オプションのヘッダーが、有効なヘッダーではありません。
NUMBER_TYPE_WITH_CALLTRACKING_NOT_SUPPORTED_FOR_COUNTRY 電話番号が国のコール トラッキングに対応していません。
RESERVED_KEYWORD_OTHER 入力が予約済みキーワードと同一です
DUPLICATE_OPTION_LABELS メッセージ表示オプションの各オプション ラベルは一意である必要があります。
DUPLICATE_OPTION_PREFILLS メッセージ表示オプションに事前入力された各オプションは一意である必要があります。
UNEQUAL_LIST_LENGTHS メッセージ表示オプションでは、オプションのラベルと事前入力の数が同じである必要があります。
INCONSISTENT_CURRENCY_CODES 広告表示オプションの通貨コードはすべて同じである必要があります。
PRICE_EXTENSION_HAS_DUPLICATED_HEADERS 価格表示オプションのヘッダーが一意ではありません。
ITEM_HAS_DUPLICATED_HEADER_AND_DESCRIPTION 項目のヘッダーと説明が同じです。
PRICE_EXTENSION_HAS_TOO_FEW_ITEMS 価格表示オプションのアイテムが少なすぎます。
UNSUPPORTED_VALUE 指定された値はサポートされていません。
INVALID_FINAL_MOBILE_URL モバイルの最終ページ URL が無効です。
INVALID_KEYWORDLESS_AD_RULE_LABEL 指定したラベルの文字列値に無効な文字が含まれています
VALUE_TRACK_PARAMETER_NOT_SUPPORTED 指定された URL には値のトラッキング パラメータが含まれています。
UNSUPPORTED_VALUE_IN_SELECTED_LANGUAGE 指定された値は、拡張機能の選択した言語でサポートされていません。
PROMOTION_INVALID_TIME プロモーションの期間が無効です。
PROMOTION_CANNOT_SET_PERCENT_OFF_AND_MONEY_AMOUNT_OFF 割引率と割引額の両方のフィールドが設定されています。
PROMOTION_CANNOT_SET_PROMOTION_CODE_AND_ORDERS_OVER_AMOUNT プロモーション コードと [注文数] のフィールドの両方が設定されています。
TOO_MANY_DECIMAL_PLACES_SPECIFIED 指定した小数点以下の桁が多すぎます。
AD_CUSTOMIZERS_NOT_ALLOWED 広告カスタマイザは存在しており、使用できません。
INVALID_LANGUAGE_CODE 言語コードが無効です。
UNSUPPORTED_LANGUAGE サポートされていない言語です。
IF_FUNCTION_NOT_ALLOWED IF 関数が存在し、使用できません。
INVALID_FINAL_URL_SUFFIX 最終ページ URL のサフィックスが無効です。
INVALID_TAG_IN_FINAL_URL_SUFFIX 最終ページ URL のサフィックスに無効なタグが含まれています。
INVALID_FINAL_URL_SUFFIX_FORMAT 最終ページ URL のサフィックスの形式が正しくありません。
ONLY_ONE_DELIVERY_OPTION_IS_ALLOWED 複数のメール配信オプションが設定されています。
NO_DELIVERY_OPTION_IS_SET メール配信オプションが設定されていません。
INVALID_CONVERSION_REPORTING_STATE コンバージョン レポートの状態フィールドの文字列値が無効です。
IMAGE_SIZE_WRONG 画像サイズが不適切です。
EMAIL_DELIVERY_NOT_AVAILABLE_IN_COUNTRY [国コード] フィールドで指定された国ではメール配信がサポートされていません。
AUTO_REPLY_NOT_AVAILABLE_IN_COUNTRY 国コード フィールドで指定された国では自動返信がサポートされていません。
INVALID_LATITUDE_VALUE 緯度に無効な値が指定されています。
INVALID_LONGITUDE_VALUE 経度に無効な値が指定されています。
TOO_MANY_LABELS 指定されているラベルのフィールドが多すぎます。
INVALID_IMAGE_URL 画像の URL が無効です。
MISSING_LATITUDE_VALUE 緯度の値が指定されていません。
MISSING_LONGITUDE_VALUE 経度の値がありません。
ADDRESS_NOT_FOUND 住所が見つかりません。
ADDRESS_NOT_TARGETABLE 指定した住所はターゲットに設定できません。
INVALID_ASSET_ID 指定されたアセット ID は存在しません。
INCOMPATIBLE_ASSET_TYPE このアセットタイプは設定できません。
IMAGE_ERROR_UNEXPECTED_SIZE 画像のサイズが想定外です。
IMAGE_ERROR_ASPECT_RATIO_NOT_ALLOWED 画像のアスペクト比が不適切です。
IMAGE_ERROR_FILE_TOO_LARGE 画像ファイルが大きすぎます。
IMAGE_ERROR_FORMAT_NOT_ALLOWED この画像形式はサポートされていません。
IMAGE_ERROR_CONSTRAINTS_VIOLATED 画像が制約に違反しているため、詳細が説明されていません。
IMAGE_ERROR_SERVER_ERROR イメージの検証中にエラーが発生しました。

FeedItemQualityApprovalStatus

フィード アイテムの品質評価の承認ステータスです。

列挙型
UNSPECIFIED 値が指定されていません。
UNKNOWN 戻り値にのみ使用されます。このバージョンで不明な値を表します。
APPROVED 要求される品質をすべて満たしている。
DISAPPROVED 要求される品質に達していない。具体的な理由は QualityDisapprovalReasons フィールドにあります。

FeedItemQualityDisapprovalReason

フィード アイテムが品質評価で不承認となった理由として考えられるもの。

列挙型
UNSPECIFIED 値が指定されていません。
UNKNOWN 戻り値にのみ使用されます。このバージョンで不明な値を表します。
PRICE_TABLE_REPETITIVE_HEADERS 価格のヘッダーに重複しているものがあります。
PRICE_TABLE_REPETITIVE_DESCRIPTION 価格の説明に重複しているものがあります。
PRICE_TABLE_INCONSISTENT_ROWS 価格に矛盾するアイテムが含まれています。
PRICE_DESCRIPTION_HAS_PRICE_QUALIFIERS 商品説明に価格の修飾子が含まれています。
PRICE_UNSUPPORTED_LANGUAGE 価格にサポートされていない言語が含まれています。
PRICE_TABLE_ROW_HEADER_TABLE_TYPE_MISMATCH 価格アイテムのヘッダーと価格タイプに関連性がありません。
PRICE_TABLE_ROW_HEADER_HAS_PROMOTIONAL_TEXT 価格アイテムのヘッダーにプロモーション テキストが含まれています。
PRICE_TABLE_ROW_DESCRIPTION_NOT_RELEVANT 価格項目の説明と項目の見出しに関連性がありません。
PRICE_TABLE_ROW_DESCRIPTION_HAS_PROMOTIONAL_TEXT 価格項目の説明にプロモーション テキストが含まれています。
PRICE_TABLE_ROW_HEADER_DESCRIPTION_REPETITIVE 価格項目のヘッダーと説明の内容が重複しています。
PRICE_TABLE_ROW_UNRATEABLE 価格アイテムが外国語であるか、意味を成さないか、評価できません。
PRICE_TABLE_ROW_PRICE_INVALID 価格アイテムの価格が無効であるか不正確です。
PRICE_TABLE_ROW_URL_INVALID 価格項目の URL が無効であるか無関係です。
PRICE_HEADER_OR_DESCRIPTION_HAS_PRICE 価格項目のヘッダーまたは説明に価格が含まれています。
STRUCTURED_SNIPPETS_HEADER_POLICY_VIOLATED 構造化スニペットの値がヘッダーと一致しません。
STRUCTURED_SNIPPETS_REPEATED_VALUES 構造化スニペットの値が重複しています。
STRUCTURED_SNIPPETS_EDITORIAL_GUIDELINES 構造化スニペットの値が、句読点などの編集ガイドラインに違反しています。
STRUCTURED_SNIPPETS_HAS_PROMOTIONAL_TEXT 構造化スニペットにプロモーション テキストが含まれています。