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_generate_data，這樣 Google Ads 就會使用正確的屬性更新動態饋給。無法在 UPDATE 時執行。使用 attributeOperations 新增屬性。
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。如果類別篩選器中沒有任何項目，則所有商店資訊都適合同步處理。
labelFilters[]

string

可用於按標籤篩選商家檔案資訊。如果標籤篩選器中有項目，則只有已設定任一標籤的清單，才能同步處理至 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 一般零售商關係。