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.
}
Các 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)

Các 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 system_feed_generative_data . Trong trường hợp đó, Google Ads sẽ cập nhật nguồn cấp dữ liệu bằng các thuộc tính chính xác. Không được phép trên UPDATE. Hãy 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 các thuộc tính của nguồn cấp dữ liệu. Bạn chỉ có thể thêm chứ không xoá được 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 nhóm system_feed_generation_data. Dữ liệu hệ thống của Nguồn cấp dữ liệu. Dữ liệu này nêu rõ thông tin về cách 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 đây:
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 một 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 được 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. Một thuộc tính nguồn cấp dữ liệu duy nhất sẽ chỉ định loại hàm FeedItemAttributes dự kiến có cùng FeedAttributeId. Nếu muốn, bạn có thể đánh dấu thuộc tính nguồn cấp dữ liệu là một phần trong khoá duy nhất của mục nguồn cấp dữ liệu.

Biểu diễn dưới dạng JSON 
{
  "type": enum (FeedAttributeType),
  "id": string,
  "name": string,
  "isPartOfKey": boolean
}
Các 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 dữ liệu tương ứng với thuộc tính này là một phần trong khoá duy nhất của 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 giản đồ của Nguồn cấp dữ liệu không bắt buộc phải có khoá duy nhất. Trong trường hợp này, FeedItems phải được tham chiếu bằng feed_item_id của chúng.

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 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.
INT64 Int64.
DOUBLE Gấp đôi.
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)
  }
}
Các trường
operator

enum (Operator)

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

object (FeedAttribute)

Chỉ có đầu ra. Thuộc tính của 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 này vào các thuộc tính hiện có.

FeedOrigin

Các giá trị có thể sử dụng cho nguồn gốc nguồn cấp dữ liệu.

Enum
UNSPECIFIED Chưa 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.
USER Thuộc tính nguồn cấp dữ liệu 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 Nguồn cấp dữ liệu cho nguồn cấp dữ liệu của GOOGLE là do Google tạo. Một 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 phù hợp với loại phần giữ chỗ của nguồn cấp dữ liệu đó.

FeedStatus

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

Enum
UNSPECIFIED Chưa 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.
ENABLED Đã bật nguồn cấp dữ liệu.
REMOVED Nguồn cấp dữ liệu đã bị xóa.

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
}
Các 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. Không thể chọn tất cả các trường phụ.
businessAccountId

string

Mã trang Plus 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ì tất cả 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ỉ có thể biến đổi và không thể chọn được.
categoryFilters[]

string

Dùng để lọc các trang thông tin trên 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 danh sách 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 nào tồn tại trongcategoryFilters, thì tất cả danh sách đều là ứng viên để đồng bộ hóa.
labelFilters[]

string

Dùng để lọc trang thông tin trên 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ó bộ nhãn mới là đề xuất để được đồng bộ hoá vào FeedItems. Nếu không có mục nào tồn tại trong labelFilters, thì tất 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
}
Các trường
httpMethod

string

Phương thức HTTP được dùng để yêu cầu uỷ quyền.
httpRequestUrl

string

URL yêu cầu HTTP được 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 một 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 được chỉ định.

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

string (int64 format)

Danh sách chuỗi cửa hàng sẽ sử dụng nguồn cấp dữ liệu vị trí của đơn vị liên kết để đồ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

Giá trị có thể có 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 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.
GENERAL_RETAILER Mối quan hệ chung với nhà bán lẻ.