Feed

Nguồn cấp dữ liệu.

Biểu diễn dưới dạng 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.
}
Trường
resourceName

string

Không thể thay đổi. Tên tài nguyên của nguồn cấp dữ liệu. Tên tài nguyên nguồn cấp dữ liệu có dạng:

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

object (FeedAttribute)

Thuộc tính của Nguồn cấp dữ liệu. Bắt buộc vào ngày CREATE, trừ phi bạn cung cấp dữ liệu system_feed_generative_data. Trong trường hợp đó, Google Ads sẽ cập nhật nguồn cấp dữ liệu với các thuộc tính chính xác. Không được phép đối với CẬP NHẬT. Sử dụng attributeOperations để thêm các thuộc tính mới.
attributeOperations[]

object (FeedAttributeOperation)

Danh sách các thao tác thay đổi thuộc tính của nguồn cấp dữ liệu. Bạn chỉ có thể thêm chứ không thể xoá thuộc tính.
origin

enum (FeedOrigin)

Không thể thay đổi. Chỉ định người quản lý FeedAttributes cho Nguồn cấp dữ liệu.
status

enum (FeedStatus)

Chỉ có đầu ra. Trạng thái của nguồn cấp dữ liệu. Trường này chỉ để đọc.
id

string (int64 format)

Chỉ có đầu ra. Mã của nguồn cấp dữ liệu. Trường này chỉ để đọc.
name

string

Không thể thay đổi. Tên của nguồn cấp dữ liệu. Bắt buộc.
Trường hợp system_feed_generation_data. Dữ liệu hệ thống của Nguồn cấp dữ liệu. Dữ liệu này chỉ định thông tin để tạo các mục trong nguồn cấp dữ liệu của nguồn cấp dữ liệu do hệ thống tạo. system_feed_generation_data chỉ có thể là một trong những trạng thái sau:
placesLocationFeedData

object (PlacesLocationFeedData)

Dữ liệu dùng để thiết lập nguồn cấp dữ liệu vị trí được điền từ Trang doanh nghiệp.
affiliateLocationFeedData

object (AffiliateLocationFeedData)

Dữ liệu dùng để định cấu hình nguồn cấp dữ liệu vị trí của đơn vị liên kết được điền sẵn các chuỗi đã chỉ định.

FeedAttribute

FeedAttributes xác định các loại dữ liệu dự kiến sẽ xuất hiện trong Nguồn cấp dữ liệu. Chỉ một FeedAttributes chỉ định loại dự kiến của FeedItemAttributes có cùng FeedAttributeId. Nếu muốn, bạn có thể đánh dấu FeedAttribute là một phần trong khoá duy nhất của FeedItem.

Biểu diễn dưới dạng JSON 
{
  "type": enum (FeedAttributeType),
  "id": string,
  "name": string,
  "isPartOfKey": boolean
}
Trường
type

enum (FeedAttributeType)

Loại dữ liệu cho thuộc tính của nguồn cấp dữ liệu. Bắt buộc.
id

string (int64 format)

Mã nhận dạng của thuộc tính.
name

string

Tên của thuộc tính. Bắt buộc.
isPartOfKey

boolean

Cho biết rằng dữ liệu tương ứng với thuộc tính này thuộc khoá duy nhất của Mục nguồn cấp dữ liệu. Thuộc tính này mặc định là false nếu không được chỉ định. Xin lưu ý rằng bạn không bắt buộc phải nhập khoá duy nhất trong giản đồ của Nguồn cấp dữ liệu. Trong trường hợp đó, FeedItems phải được tham chiếu bằng feed_item_id.

FeedAttributeType

Các loại dữ liệu có thể có cho một thuộc tính của nguồn cấp dữ liệu.

Enum
UNSPECIFIED Chưa chỉ định.
UNKNOWN Chỉ dùng cho giá trị trả về. Đại diện cho giá trị không xác định trong phiên bản này.
INT64 Int64.
DOUBLE Kép.
STRING Chuỗi.
BOOLEAN Boolean.
URL URL.
DATE_TIME Ngày giờ.
INT64_LIST Danh sách Int64.
DOUBLE_LIST Danh sách kép (8 byte).
STRING_LIST Danh sách chuỗi.
BOOLEAN_LIST Danh sách boolean
URL_LIST Danh sách URL.
DATE_TIME_LIST Danh sách ngày giờ.
PRICE Giá.

FeedAttributeOperation

Thao tác cần thực hiện đối với danh sách thuộc tính của nguồn cấp dữ liệu trong một biến đổi.

Biểu diễn dưới dạng JSON 
{
  "operator": enum (Operator),
  "value": {
    object (FeedAttribute)
  }
}
Trường
operator

enum (Operator)

Chỉ có đầu ra. Loại toán tử danh sách cần thực hiện.
value

object (FeedAttribute)

Chỉ có đầu ra. Thuộc tính nguồn cấp dữ liệu đang được thêm vào danh sách.

Đơn vị tổ chức

Toán tử.

Enum
UNSPECIFIED Không xác định.
UNKNOWN Chỉ dùng cho giá trị trả về. Đại diện cho giá trị không xác định trong phiên bản này.
ADD Thêm thuộc tính vào các thuộc tính hiện có.

FeedOrigin

Các giá trị có thể có cho một nguồn gốc nguồn cấp dữ liệu.

Enum
UNSPECIFIED Chưa chỉ định.
UNKNOWN Chỉ dùng cho giá trị trả về. Đại diện cho giá trị không xác định trong phiên bản này.
USER FeedAttributes cho Nguồn cấp dữ liệu này do người dùng quản lý. Người dùng có thể thêm FeedAttributes vào Nguồn cấp dữ liệu này.
GOOGLE FeedAttributes cho Nguồn cấp dữ liệu của GOOGLE là do Google tạo. Nguồn cấp dữ liệu thuộc loại này do Google duy trì và sẽ có các thuộc tính chính xác cho loại phần giữ chỗ của nguồn cấp dữ liệu.

FeedStatus

Trạng thái có thể có của nguồn cấp dữ liệu.

Enum
UNSPECIFIED Chưa chỉ định.
UNKNOWN Chỉ dùng cho giá trị trả về. Đại diện cho giá trị không xác định trong phiên bản này.
ENABLED Nguồn cấp dữ liệu đã được bật.
REMOVED Đã xoá nguồn cấp dữ liệu.

PlacesLocationFeedData

Dữ liệu dùng để thiết lập nguồn cấp dữ liệu vị trí được điền từ Trang doanh nghiệp.

Biểu diễn dưới dạng JSON 
{
  "oauthInfo": {
    object (OAuthInfo)
  },
  "businessAccountId": string,
  "categoryFilters": [
    string
  ],
  "labelFilters": [
    string
  ],
  "emailAddress": string,
  "businessNameFilter": string
}
Trường
oauthInfo

object (OAuthInfo)

Không thể thay đổi. Mã thông báo xác thực bắt buộc (từ API OAuth) cho email. Bạn chỉ có thể chỉ định trường này trong yêu cầu tạo. Bạn không thể chọn tất cả các trường phụ của tài khoản này.
businessAccountId

string

Mã trang bổ sung của doanh nghiệp được quản lý có vị trí sẽ được sử dụng. Nếu bạn không đặt trường này, thì mọi doanh nghiệp mà người dùng có thể truy cập (do emailAddress) sẽ được sử dụng. Trường này chỉ để thay đổi và không thể chọn được.
categoryFilters[]

string

Dùng để lọc Trang doanh nghiệp theo danh mục. Nếu các mục nhập tồn tại trongcategoryFilters, thì chỉ các trang thông tin thuộc bất kỳ danh mục nào mới là ứng viên để được đồng bộ hóa vào FeedItems. Nếu không có mục nhập nào tồn tại trongcategoryFilters, thì tất cả danh sách đều là ứng dụng để đồng bộ hóa.
labelFilters[]

string

Dùng để lọc trang thông tin trong Trang doanh nghiệp theo nhãn. Nếu các mục tồn tại trong labelFilters, thì chỉ những trang thông tin đã được đặt nhãn mới là ứng viên để đồng bộ hoá với FeedItems. Nếu không có mục nhập nào trong labelFilters thì tất cả các danh sách đều là ứng viên để đồng bộ hóa.
emailAddress

string

Địa chỉ email của một Trang doanh nghiệp hoặc địa chỉ email của người quản lý Trang doanh nghiệp đó. Bắt buộc.
businessNameFilter

string

Dùng để lọc trang thông tin trên Trang doanh nghiệp theo tên doanh nghiệp. Nếu bạn đặt businessNameFilter, thì chỉ những trang thông tin có tên doanh nghiệp trùng khớp mới được đồng bộ hoá vào FeedItems.

OAuthInfo

Dữ liệu dùng để uỷ quyền bằng OAuth.

Biểu diễn dưới dạng JSON 
{
  "httpMethod": string,
  "httpRequestUrl": string,
  "httpAuthorizationHeader": string
}
Trường
httpMethod

string

Phương thức HTTP đã dùng để được cấp quyền.
httpRequestUrl

string

URL yêu cầu HTTP đã dùng để được cấp quyền.
httpAuthorizationHeader

string

Tiêu đề uỷ quyền HTTP được dùng để được uỷ quyền.

AffiliateLocationFeedData

Dữ liệu dùng để định cấu hình nguồn cấp dữ liệu vị trí của đơn vị liên kết được điền sẵn các chuỗi đã chỉ định.

Biểu diễn dưới dạng JSON 
{
  "chainIds": [
    string
  ],
  "relationshipType": enum (AffiliateLocationFeedRelationshipType)
}
Trường
chainIds[]

string (int64 format)

Danh sách chuỗi mà nguồn cấp dữ liệu vị trí của đơn vị liên kết sẽ đồng bộ hoá các vị trí đó.
relationshipType

enum (AffiliateLocationFeedRelationshipType)

Mối quan hệ của chuỗi với nhà quảng cáo.

AffiliateLocationFeedRelationshipType

Các giá trị có thể sử dụng cho loại mối quan hệ cho nguồn cấp dữ liệu vị trí của đơn vị liên kết.

Enum
UNSPECIFIED Chưa chỉ định.
UNKNOWN Chỉ dùng cho giá trị trả về. Đại diện cho giá trị không xác định trong phiên bản này.
GENERAL_RETAILER Mối quan hệ chung của nhà bán lẻ.