Feed

動態饋給。

JSON 表示法 
{
  "resourceName": string,
  "attributes": [
    {
      object (FeedAttribute)
    }
  ],
  "attributeOperations": [
    {
      object (FeedAttributeOperation)
    }
  ],
  "origin": enum (FeedOrigin),
  "status": enum (FeedStatus),
  "id": string,
  "name": string,

  // Union field system_feed_generation_data can be only one of the following:
  "placesLocationFeedData": {
    object (PlacesLocationFeedData)
  },
  "affiliateLocationFeedData": {
    object (AffiliateLocationFeedData)
  }
  // End of list of possible types for union field system_feed_generation_data.
}
欄位
resourceName

string

不可變動。動態饋給的資源名稱。動態饋給資源名稱的格式如下：

customers/{customerId}/feeds/{feedId}
attributes[]

object (FeedAttribute)

動態饋給的屬性。建立 CREATE 時，除非提供 system_feed_generation_data，因此 Google Ads 會使用正確的屬性更新動態饋給。在 UPDATE 上不允許使用。使用屬性 Operations 新增屬性。
attributeOperations[]

object (FeedAttributeOperation)

列出變更動態饋給屬性的作業。您只能新增屬性，不能移除。
origin

enum (FeedOrigin)

不可變動。指定由誰管理動態消息的 FeedAttributes。
status

enum (FeedStatus)

僅供輸出。動態饋給的狀態。這是唯讀欄位。
id

string (int64 format)

僅供輸出。動態饋給的 ID。這是唯讀欄位。
name

string

不可變動。動態饋給的名稱。這是必填欄位。
聯集欄位 system_feed_generation_data。「動態提醒」的系統資料。這項資料會指定相關資訊，用於為系統產生的動態饋給產生動態饋給項目。system_feed_generation_data 只能是下列其中一項：
placesLocationFeedData

object (PlacesLocationFeedData)

用於設定從商家檔案填入的地點動態饋給的資料。
affiliateLocationFeedData

object (AffiliateLocationFeedData)

用於設定已填入指定連鎖店的經銷地點動態饋給的資料。

FeedAttribute

FeedAttributes 可定義要在動態饋給中顯示的資料類型。單一 FeedAttribute 會指定具有相同 FeedAttributeId 的 FeedItemAttributes 預期類型。您可以選擇將 FeedAttribute 標示為 FeedItem 專屬鍵的一部分。

JSON 表示法 
{
  "type": enum (FeedAttributeType),
  "id": string,
  "name": string,
  "isPartOfKey": boolean
}
欄位
type

enum (FeedAttributeType)

動態饋給屬性的資料類型。這是必填欄位。
id

string (int64 format)

屬性的 ID。
name

string

屬性的名稱。這是必填欄位。
isPartOfKey

boolean

表示與此屬性相對應的資料是 FeedItem 專屬鍵的一部分。如未指定，則預設為 False。請注意，動態饋給結構定義中不需要使用專屬鍵，在此情況下， FeedItems 必須使用相關的 feed_item_id 參照。

FeedAttributeType

動態饋給屬性可能的資料類型。

列舉
UNSPECIFIED 未指定。
UNKNOWN 僅用於傳回值。代表這個版本未知的值。
INT64 Int64。
DOUBLE 雙精準數。
STRING 字串。
BOOLEAN Boolean 值。
URL 網址。
DATE_TIME 日期時間。
INT64_LIST Int64 清單。
DOUBLE_LIST 雙精準數 (8 個位元組) 清單。
STRING_LIST 字串清單。
BOOLEAN_LIST 布林值清單。
URL_LIST 網址清單。
DATE_TIME_LIST 日期時間清單。
PRICE 價格。

FeedAttributeOperation

要對變更中的資訊提供屬性清單執行的操作。

JSON 表示法 
{
  "operator": enum (Operator),
  "value": {
    object (FeedAttribute)
  }
}
欄位
operator

enum (Operator)

僅供輸出。要執行的清單作業類型。
value

object (FeedAttribute)

僅供輸出。加入清單中的動態饋給屬性。

運作資源

運算子。

列舉
UNSPECIFIED 未指明
UNKNOWN 僅用於傳回值。代表這個版本未知的值。
ADD 將屬性新增至現有屬性。

FeedOrigin

動態饋給來源的可能值。

列舉
UNSPECIFIED 未指定。
UNKNOWN 僅用於傳回值。代表這個版本未知的值。
USER 這個動態饋給的 FeedAttributes 是由使用者管理。使用者可以將 FeedAttributes 新增至這個動態饋給。
GOOGLE GOOGLE 動態消息的 FeedAttributes 是由 Google 所建立。這種類型的動態饋給是由 Google 維護，且針對動態饋給的預留位置類型會有正確的屬性。

FeedStatus

動態饋給的可能狀態。

列舉
UNSPECIFIED 未指定。
UNKNOWN 僅用於傳回值。代表這個版本未知的值。
ENABLED 動態饋給已啟用。
REMOVED 動態饋給已移除。

PlacesLocationFeedData

用於設定從商家檔案填入的地點動態饋給的資料。

JSON 表示法 
{
  "oauthInfo": {
    object (OAuthInfo)
  },
  "businessAccountId": string,
  "categoryFilters": [
    string
  ],
  "labelFilters": [
    string
  ],
  "emailAddress": string,
  "businessNameFilter": string
}
欄位
oauthInfo

object (OAuthInfo)

不可變動。電子郵件的必要驗證權杖 (來自 OAuth API)。這個欄位只能在建立要求中指定。無法選取其所有子欄位。
businessAccountId

string

應使用地點的受管理商家的 Google+ 專頁 ID。如未設定這個欄位，系統會採用使用者可存取的所有商家資訊 (以 emailAddress 指定)。此欄位僅限變更，無法選取。
categoryFilters[]

string

用於按類別篩選商家檔案資訊。如果類別篩選器中的項目存在，則只有屬於任一類別的商家資訊可同步至 FeedItems。如果 categoryFilters 上沒有任何項目，則所有清單項目都會經過同步處理。
labelFilters[]

string

可依標籤篩選商家檔案資訊。如果 labelFilters 中的項目存在，則只有具有標籤組合的清單才能與 FeedItems 同步處理。如果 labelFilters 中沒有項目，則所有清單項目都適合進行同步處理。
emailAddress

string

商家檔案的電子郵件地址，或是商家檔案管理員的電子郵件地址。這是必填欄位。
businessNameFilter

string

用於依商家名稱篩選商家檔案資訊。如果設定了 businessNameFilter，只有商家名稱相符的商家資訊才能同步處理至 FeedItems。

OAuthInfo

使用 OAuth 進行授權所用的資料。

JSON 表示法 
{
  "httpMethod": string,
  "httpRequestUrl": string,
  "httpAuthorizationHeader": string
}
欄位
httpMethod

string

用於取得授權的 HTTP 方法。
httpRequestUrl

string

用來取得授權的 HTTP 要求網址。
httpAuthorizationHeader

string

用來取得授權的 HTTP 授權標頭。

AffiliateLocationFeedData

用於設定已填入指定連鎖店的經銷地點動態饋給的資料。

JSON 表示法 
{
  "chainIds": [
    string
  ],
  "relationshipType": enum (AffiliateLocationFeedRelationshipType)
}
欄位
chainIds[]

string (int64 format)

經銷地點動態饋給會同步不同地點的連鎖店清單。
relationshipType

enum (AffiliateLocationFeedRelationshipType)

連鎖店與廣告主的關係。

AffiliateLocationFeedRelationshipType

經銷地點動態饋給的關係類型可能的值。

列舉
UNSPECIFIED 未指定。
UNKNOWN 僅用於傳回值。代表這個版本未知的值。
GENERAL_RETAILER 一般零售商關係。