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、URL 或 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` 僅供輸出。與這項錯誤相關的額外資訊請注意，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`	缺少 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`	無法識別廣告參數中的值類型。
`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`	指定的網址包含 ValueTrack 參數。
`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`	網站簡介包含宣傳文字。