AssetSet

Một nhóm thành phần đại diện cho một tập hợp các thành phần. Sử dụng AssetSetAsset để liên kết một thành phần với nhóm thành phần.

Biểu diễn dưới dạng JSON
{
  "id": string,
  "resourceName": string,
  "name": string,
  "type": enum (AssetSetType),
  "status": enum (AssetSetStatus),
  "merchantCenterFeed": {
    object (MerchantCenterFeed)
  },
  "locationGroupParentAssetSetId": string,
  "hotelPropertyData": {
    object (HotelPropertyData)
  },

  // Union field asset_set_source can be only one of the following:
  "locationSet": {
    object (LocationSet)
  },
  "businessProfileLocationGroup": {
    object (BusinessProfileLocationGroup)
  },
  "chainLocationGroup": {
    object (ChainLocationGroup)
  }
  // End of list of possible types for union field asset_set_source.
}
Các trường
id

string (int64 format)

Chỉ có đầu ra. Mã của nhóm thành phần.

resourceName

string

Không thể thay đổi. Tên tài nguyên của nhóm thành phần. Tên tài nguyên của nhóm thành phần có dạng:

customers/{customerId}/assetSets/{asset_set_id}

name

string

Bắt buộc. Tên của nhóm thành phần. Bắt buộc. Mã này phải có độ dài tối thiểu là 1 và độ dài tối đa là 128.

type

enum (AssetSetType)

Bắt buộc. Không thể thay đổi. Loại của nhóm thành phần. Bắt buộc.

status

enum (AssetSetStatus)

Chỉ có đầu ra. Trạng thái của nhóm thành phần. Chỉ đọc.

merchantCenterFeed

object (MerchantCenterFeed)

Mã người bán và Nhãn nguồn cấp dữ liệu trong Google Merchant Center.

locationGroupParentAssetSetId

string (int64 format)

Không thể thay đổi. Mã nhóm thành phần gốc cho tập hợp thành phần chứa các phần tử của nhóm thành phần này. Ví dụ: mã nhận dạng AssetSet của vị trí ở cấp độ đồng bộ hoá, nơi chứa các phần tử trong LocationGroup AssetSet. Đây là trường bắt buộc và chỉ áp dụng cho AssetSet đã nhập Nhóm địa điểm.

hotelPropertyData

object (HotelPropertyData)

Chỉ có đầu ra. Đối với chiến dịch Tối đa hoá hiệu suất cho các mục tiêu trong ngành du lịch có đường liên kết đến tài khoản Hotel Center. Chỉ đọc.

Trường nhóm asset_set_source. Dữ liệu về nhóm thành phần dành riêng cho từng loại nhóm thành phần. Không phải mọi loại đều có dữ liệu cụ thể. asset_set_source chỉ có thể là một trong những trạng thái sau đây:
locationSet

object (LocationSet)

Dữ liệu về nhóm thành phần địa điểm. Thông tin này sẽ được dùng cho việc thiết lập vị trí ở cấp đồng bộ hoá. Bạn chỉ có thể đặt giá trị này nếu loại AssetSet là LOCATION_SYNC.

businessProfileLocationGroup

object (BusinessProfileLocationGroup)

Dữ liệu về nhóm thành phần nhóm địa điểm trên Trang doanh nghiệp.

chainLocationGroup

object (ChainLocationGroup)

Biểu thị thông tin về nhóm vị trí động của Chuỗi cửa hàng. Chỉ áp dụng nếu loại AssetSet ở cấp đồng bộ hoá là LOCATION_SYNC và nguồn đồng bộ hoá là chuỗi.

AssetSetStatus

Các trạng thái có thể có của một nhóm thành phần.

Enum
UNSPECIFIED Trạng thái chưa được chỉ định.
UNKNOWN Không xác định được giá trị đã nhận trong phiên bản này. Đây là giá trị chỉ để phản hồi.
ENABLED Nhóm thành phần đã được bật.
REMOVED Nhóm thành phần đã bị xoá.

MerchantCenterFeed

Mã người bán và Nhãn nguồn cấp dữ liệu trong Google Merchant Center.

Biểu diễn dưới dạng JSON
{
  "merchantId": string,
  "feedLabel": string
}
Các trường
merchantId

string (int64 format)

Bắt buộc. Mã người bán trong Google Merchant Center

feedLabel

string

Không bắt buộc. Nhãn nguồn cấp dữ liệu từ Google Merchant Center.

HotelPropertyData

Đối với chiến dịch Tối đa hoá hiệu suất cho các mục tiêu trong ngành du lịch có đường liên kết đến tài khoản Hotel Center. Chỉ đọc.

Biểu diễn dưới dạng JSON
{
  "hotelCenterId": string,
  "partnerName": string
}
Các trường
hotelCenterId

string (int64 format)

Chỉ có đầu ra. Mã Hotel Center của đối tác.

partnerName

string

Chỉ có đầu ra. Tên của đối tác khách sạn.

LocationSet

Dữ liệu liên quan đến thiết lập vị trí. Bạn cần chỉ định một trong các dữ liệu Trang doanh nghiệp trên Google (trước đây là Google Doanh nghiệp của tôi), Dữ liệu chuỗi và dữ liệu vị trí trên bản đồ.

Biểu diễn dưới dạng JSON
{
  "locationOwnershipType": enum (LocationOwnershipType),

  // Union field source can be only one of the following:
  "businessProfileLocationSet": {
    object (BusinessProfileLocationSet)
  },
  "chainLocationSet": {
    object (ChainSet)
  },
  "mapsLocationSet": {
    object (MapsLocationSet)
  }
  // End of list of possible types for union field source.
}
Các trường
locationOwnershipType

enum (LocationOwnershipType)

Bắt buộc. Không thể thay đổi. Loại quyền sở hữu vị trí (vị trí sở hữu hoặc vị trí của đơn vị liên kết).

Trường nhóm source. Dữ liệu vị trí dành riêng cho từng nguồn đồng bộ hoá. source chỉ có thể là một trong những trạng thái sau đây:
businessProfileLocationSet

object (BusinessProfileLocationSet)

Dữ liệu được dùng để định cấu hình một nhóm vị trí được điền sẵn từ các vị trí trong Trang doanh nghiệp trên Google.

chainLocationSet

object (ChainSet)

Dữ liệu dùng để định cấu hình một vị trí trên chuỗi được điền sẵn bằng các chuỗi được chỉ định.

mapsLocationSet

object (MapsLocationSet)

Chỉ đặt nếu các vị trí được đồng bộ hoá dựa trên những vị trí đã chọn trên bản đồ

BusinessProfileLocationSet

Dữ liệu được dùng để định cấu hình một nhóm vị trí được điền sẵn từ các vị trí trong Trang doanh nghiệp trên Google. Các loại bộ lọc khác nhau được kết hợp với nhau, nếu được chỉ định.

Biểu diễn dưới dạng JSON
{
  "httpAuthorizationToken": string,
  "emailAddress": string,
  "businessNameFilter": string,
  "labelFilters": [
    string
  ],
  "listingIdFilters": [
    string
  ],
  "businessAccountId": string
}
Các trường
httpAuthorizationToken

string

Bắt buộc. Không thể thay đổi. Mã thông báo uỷ quyền HTTP được dùng để được uỷ quyền.

emailAddress

string

Bắt buộc. Không thể thay đổi. Địa chỉ email của tài khoản Trang doanh nghiệp trên Google hoặc địa chỉ email của người quản lý tài khoản Trang doanh nghiệp trên Google.

businessNameFilter

string

Dùng để lọc trang thông tin trong Trang doanh nghiệp trên Google 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 Thành phần.

labelFilters[]

string

Dùng để lọc trang thông tin trong Trang doanh nghiệp trên Google 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 Thành phần. 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. Các bộ lọc nhãn được kết hợp với nhau.

listingIdFilters[]

string (int64 format)

Dùng để lọc trang thông tin trong Trang doanh nghiệp trên Google theo mã trang thông tin. Nếu có các mục trong listingIdFilters, thì chỉ những trang thông tin do bộ lọc chỉ định mới được đồng bộ hóa với các Thành phần. Nếu không có mục nhập nào trong listingIdFilters thì tất cả danh sách đều là ứng viên để đồng bộ hóa. Các bộ lọc mã trang thông tin được kết hợp với nhau.

businessAccountId

string

Không thể thay đổi. Mã tài khoản 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.

ChainSet

Dữ liệu dùng để định cấu hình một nhóm vị trí được điền sẵn các chuỗi đã chỉ định.

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

enum (ChainRelationshipType)

Bắt buộc. Không thể thay đổi. Loại mối quan hệ mà chuỗi đã chỉ định có với nhà quảng cáo này.

chains[]

object (ChainFilter)

Bắt buộc. Danh sách bộ lọc cấp chuỗi, tất cả các bộ lọc đều được kết hợp với nhau.

ChainRelationshipType

Các loại mối quan hệ có thể có.

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.
AUTO_DEALERS Mối quan hệ của đại lý ô tô.
GENERAL_RETAILERS Mối quan hệ chung với nhà bán lẻ.

ChainFilter

Một bộ lọc cấp chuỗi về vị trí trong một nhóm mục trong nguồn cấp dữ liệu. Logic lọc giữa tất cả các trường là AND.

Biểu diễn dưới dạng JSON
{
  "chainId": string,
  "locationAttributes": [
    string
  ]
}
Các trường
chainId

string (int64 format)

Bắt buộc. Dùng để lọc vị trí chuỗi cửa hàng theo mã chuỗi. Chỉ những vị trí chuỗi thuộc chuỗi được chỉ định mới có trong nhóm thành phần.

locationAttributes[]

string

Dùng để lọc vị trí của chuỗi cửa hàng theo các thuộc tính của vị trí. Chỉ những vị trí chuỗi thuộc tất cả(các) thuộc tính đã chỉ định mới có trong nhóm thành phần. Nếu trường này trống thì tức là không lọc được trường này.

MapsLocationSet

Trình bao bọc cho dữ liệu đồng bộ hoá vị trí nhiều bản đồ

Biểu diễn dưới dạng JSON
{
  "mapsLocations": [
    {
      object (MapsLocationInfo)
    }
  ]
}
Các trường
mapsLocations[]

object (MapsLocationInfo)

Bắt buộc. Danh sách thông tin vị trí trên bản đồ mà người dùng đã đồng bộ hoá theo cách thủ công.

MapsLocationInfo

Trình bao bọc cho mã địa điểm

Biểu diễn dưới dạng JSON
{
  "placeId": string
}
Các trường
placeId

string

Mã địa điểm của vị trí trên Maps.

BusinessProfileLocationGroup

Thông tin về nhóm vị trí động trên Trang doanh nghiệp. Chỉ áp dụng nếu loại AssetSet ở cấp đồng bộ hoá là LOCATION_SYNC và nguồn đồng bộ hoá là Trang doanh nghiệp.

Biểu diễn dưới dạng JSON
{
  "dynamicBusinessProfileLocationGroupFilter": {
    object (DynamicBusinessProfileLocationGroupFilter)
  }
}
Các trường
dynamicBusinessProfileLocationGroupFilter

object (DynamicBusinessProfileLocationGroupFilter)

Lọc cho các nhóm địa điểm linh động của Trang doanh nghiệp.

DynamicBusinessProfileLocationGroupFilter

Đại diện cho một bộ lọc về các vị trí của Trang doanh nghiệp trong một nhóm thành phần. Nếu bạn cung cấp nhiều bộ lọc, thì các bộ lọc này sẽ được kết hợp với nhau.

Biểu diễn dưới dạng JSON
{
  "labelFilters": [
    string
  ],
  "listingIdFilters": [
    string
  ],
  "businessNameFilter": {
    object (BusinessProfileBusinessNameFilter)
  }
}
Các trường
labelFilters[]

string

Dùng để lọc các vị trí trên Trang doanh nghiệp theo nhãn. Chỉ những vị trí có nhãn được liệt kê mới có trong nhóm thành phần. Các bộ lọc nhãn được kết hợp với nhau.

listingIdFilters[]

string (int64 format)

Dùng để lọc các vị trí trên Trang doanh nghiệp theo mã trang thông tin.

businessNameFilter

object (BusinessProfileBusinessNameFilter)

Dùng để lọc các vị trí trên Trang doanh nghiệp theo tên doanh nghiệp.

BusinessProfileBusinessNameFilter

Bộ lọc tên doanh nghiệp của nhóm địa điểm trên Trang doanh nghiệp.

Biểu diễn dưới dạng JSON
{
  "businessName": string,
  "filterType": enum (LocationStringFilterType)
}
Các trường
businessName

string

Chuỗi tên doanh nghiệp dùng để lọc.

filterType

enum (LocationStringFilterType)

Loại so khớp chuỗi sẽ sử dụng khi lọc bằng businessName.

LocationStringFilterType

Các loại bộ lọc chuỗi vị trí có thể có.

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.
EXACT Bộ lọc sẽ sử dụng đối sánh chuỗi chính xác.

ChainLocationGroup

Biểu thị thông tin về nhóm vị trí động của Chuỗi cửa hàng. Chỉ áp dụng nếu loại AssetSet ở cấp đồng bộ hoá là LOCATION_SYNC và nguồn đồng bộ hoá là chuỗi.

Biểu diễn dưới dạng JSON
{
  "dynamicChainLocationGroupFilters": [
    {
      object (ChainFilter)
    }
  ]
}
Các trường
dynamicChainLocationGroupFilters[]

object (ChainFilter)

Dùng để lọc vị trí chuỗi cửa hàng theo mã chuỗi. Chỉ những vị trí thuộc(các) chuỗi đã chỉ định mới có trong nhóm thành phần.