FeedItem

JSON 表示法
FeedItemAttributeValue
- JSON 表示法
GeoTargetingRestriction
FeedItemPlaceholderPolicyInfo
- JSON 表示法
FeedItemValidationStatus
FeedItemValidationError
- JSON 表示法
FeedItemValidationError
FeedItemQualityApprovalStatus
FeedItemQualityDisapprovalReason

動態饋給項目。

JSON 表示法

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,
  "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)` 這份對應清單是用於取代 `trackingUrlTemplate`、`finalUrls` 或 `mobile_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 表示法

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)
  },
  "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，清單的總大小不得超過 3000。DATE_TIME_LIST 的元素數量不得超過 200 個。對於 STRING_LIST，每個字串元素的長度上限為 1500 個字元。URL_LIST 的長度上限為 2076 個字元。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、網址或 DATE_TIME 的動態饋給屬性，則應設定這個屬性。STRING 的長度上限為 1500 個字元。網址長度上限為 2076 個字元。DATE_TIME 的字串格式必須是「YYYYMMDD HHMMSS」。
`doubleValue`	`number` 雙精度浮點值。如果 feedAttributeId 參照的是 DOUBLE 類型的動態饋給屬性，則應設定這個屬性。

GeoTargetingRestriction

這項限制用於判斷要求情境的地理區域是否應相符。

列舉
`UNSPECIFIED`	未指定。
`UNKNOWN`	僅適用於傳回值。代表此版本中未知的值。
`LOCATION_OF_PRESENCE`	表示要求的背景資訊應與使用者的實際位置相符。

FeedItemPlaceholderPolicyInfo

指定預留位置類型的動態饋給項目政策、驗證和品質核准資訊。

JSON 表示法

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
}

欄位
`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 網址無效。
`MISSING_DELIVERY_ADDRESS`	電子郵件額外資訊缺少寄送地址，
`START_DATE_AFTER_END_DATE`	FeedItem 的排程開始日期晚於結束日期。
`MISSING_FEED_ITEM_START_TIME`	缺少 FeedItem 排程的開始時間。
`MISSING_FEED_ITEM_END_TIME`	動態饋給項目時段設定缺少結束時間。
`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`	為廣告參數中的值指定無法識別的類型。
`MISSING_ENHANCED_SITELINK_DESCRIPTION_LINE`	加強型網站連結必須指定兩個說明行。
`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`	網址參數名稱只能包含英文字母、數字、底線和破折號。
`NO_GEOCODING_RESULT`	找不到地址位置
`SOURCE_NAME_IN_REVIEW_EXTENSION_TEXT`	評論額外資訊文字包含來源名稱。
`CARRIER_SPECIFIC_SHORT_NUMBER_NOT_ALLOWED`	某些電話號碼可能比平時短。其中一些短號因電信業者而異，有些使用者無法使用，因此廣告額外資訊中的這類短組號碼無法供您使用。
`INVALID_PLACEHOLDER_FIELD_ID`	要求參照的預留位置欄位 ID 不存在時觸發。
`INVALID_URL_TAG`	網址包含無效的 ValueTrack 標記或格式。
`LIST_TOO_LONG`	提供的名單超過可接受的大小上限。
`INVALID_ATTRIBUTES_COMBINATION`	您無法在同一個動態饋給項目中指定某些屬性組合。
`DUPLICATE_VALUES`	屬性重複使用相同的值。
`INVALID_CALL_CONVERSION_ACTION_ID`	廣告客戶可以將轉換動作與電話號碼連結，藉此指定從該電話號碼獲得足夠長的來電應計為指定類型的轉換。這則錯誤訊息指出指定的轉換動作無效 (例如轉換動作不存在於正確的 Google Ads 帳戶中，或是該轉換動作不適用於來電轉換)。
`CANNOT_SET_WITHOUT_FINAL_URLS`	您必須設定最終到達網址，才能使用追蹤範本。
`APP_ID_DOESNT_EXIST_IN_APP_STORE`	提供的應用程式 ID 不在指定應用程式商店中。
`INVALID_FINAL_URL`	U2 最終到達網址無效。
`INVALID_TRACKING_URL`	U2 追蹤網址無效。
`INVALID_FINAL_URL_FOR_APP_DOWNLOAD_URL`	「最終到達網址」應以應用程式下載網址開頭。
`LIST_TOO_SHORT`	所提供的清單太短。
`INVALID_USER_ACTION`	使用者動作欄位含有無效的值。
`INVALID_TYPE_NAME`	類型欄位的值無效。
`INVALID_EVENT_CHANGE_STATUS`	活動變更狀態無效。
`INVALID_SNIPPETS_HEADER`	網站簡介額外資訊的標題不是有效標題。
`INVALID_ANDROID_APP_LINK`	Android 應用程式連結格式不正確
`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`	最終行動版網址無效。
`INVALID_KEYWORDLESS_AD_RULE_LABEL`	「標籤」指定的字串值包含無效字元
`VALUE_TRACK_PARAMETER_NOT_SUPPORTED`	指定網址包含值追蹤參數。
`UNSUPPORTED_VALUE_IN_SELECTED_LANGUAGE`	擴充功能中選取的語言不支援指定值。
`INVALID_IOS_APP_LINK`	iOS 應用程式連結的格式有誤。
`MISSING_IOS_APP_LINK_OR_IOS_APP_STORE_ID`	缺少 iOS 應用程式連結或 iOS App Store ID。
`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`	最終到達網址尾碼無效。
`INVALID_TAG_IN_FINAL_URL_SUFFIX`	最終到達網址尾碼包含無效代碼。
`INVALID_FINAL_URL_SUFFIX_FORMAT`	最終到達網址尾碼格式不正確。
`CUSTOMER_CONSENT_FOR_CALL_RECORDING_REQUIRED`	廣告主未提供電話錄音的同意聲明。如要使用來電額外資訊，則必須先取得同意聲明。請參閱 https://support.google.com/google-ads/answer/7412639。
`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`	圖片網址無效。
`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`	價格項目網址無效或不相關。
`PRICE_HEADER_OR_DESCRIPTION_HAS_PRICE`	價格項目標題或說明中含有價格資訊。
`STRUCTURED_SNIPPETS_HEADER_POLICY_VIOLATED`	網站簡介值與標題不符。
`STRUCTURED_SNIPPETS_REPEATED_VALUES`	網站簡介值重複。
`STRUCTURED_SNIPPETS_EDITORIAL_GUIDELINES`	網站簡介值違反標點符號等編輯指南。
`STRUCTURED_SNIPPETS_HAS_PROMOTIONAL_TEXT`	網站簡介包含宣傳文字。