AssetSet

Một nhóm thành phần đại diện cho một tập hợp 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.
}
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 tài sản. Tên tài nguyên nhóm tài sả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. Chuỗi này phải có độ dài tối thiểu là 1 và tối đa là 128.

type

enum (AssetSetType)

Bắt buộc. Không thể thay đổi. Loại 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ó thể đọ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 mẹ của nhóm thành phần nơi các phần tử của nhóm thành phần này đến. Ví dụ: mã nhận dạng AssetSet địa điểm ở cấp đồng bộ hoá, nơi các phần tử trong AssetSet LocationGroup đến. Đây là trường bắt buộc và chỉ áp dụng cho AssetSet thuộc loại Nhóm vị trí.

hotelPropertyData

object (HotelPropertyData)

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

Trường hợp hợp nhất asset_set_source. Dữ liệu 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 loại nào cũng có dữ liệu cụ thể. asset_set_source chỉ có thể là một trong những giá trị sau:
locationSet

object (LocationSet)

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

businessProfileLocationGroup

object (BusinessProfileLocationGroup)

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

chainLocationGroup

object (ChainLocationGroup)

Biểu thị thông tin về một nhóm vị trí động của chuỗi cửa hàng. Chỉ áp dụng nếu loại của 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 Chưa chỉ định trạng thái.
UNKNOWN Không xác định được giá trị nhận được 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 Tập hợp 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
}
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 mục tiêu về du lịch có liên kết với tài khoản Hotel Center. Chỉ có thể đọc.

Biểu diễn dưới dạng JSON
{
  "hotelCenterId": string,
  "partnerName": string
}
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 nhóm 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 cửa hàng 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.
}
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í thuộc sở hữu hoặc vị trí của đơn vị liên kết).

Trường hợp hợp nhất 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 giá trị sau:
businessProfileLocationSet

object (BusinessProfileLocationSet)

Dữ liệu dùng để định cấu hình một tập hợp vị trí được điền từ các vị trí trên 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 nhóm chuỗi được điền sẵn các chuỗi đã chỉ định.

mapsLocationSet

object (MapsLocationSet)

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

BusinessProfileLocationSet

Dữ liệu dùng để định cấu hình một tập hợp vị trí được điền từ các vị trí trên 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 bằng toán tử AND (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
}
Trường
httpAuthorizationToken

string

Bắt buộc. Không thể thay đổi. Mã uỷ quyền HTTP dùng để nhận quyền 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 khớp mới là ứng cử viên để đồng bộ hoá vào Thành phần.

labelFilters[]

string

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

listingIdFilters[]

string (int64 format)

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

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 chỉ định) 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)
    }
  ]
}
Trường
relationshipType

enum (ChainRelationshipType)

Bắt buộc. Không thể thay đổi. Loại mối quan hệ của các chuỗi đã chỉ định 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ả bộ lọc được kết hợp với nhau bằng toán tử OR.

ChainRelationshipType

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

Enum
UNSPECIFIED Chưa chỉ định.
UNKNOWN Chỉ dùng cho giá trị trả về. Biểu thị giá trị không xác định trong phiên bản này.
AUTO_DEALERS Mối quan hệ với đại lý ô tô.
GENERAL_RETAILERS Mối quan hệ với nhà bán lẻ tổng hợp.

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
  ]
}
Trường
chainId

string (int64 format)

Bắt buộc. Dùng để lọc các vị trí theo chuỗi cửa hàng theo mã chuỗi cửa hàng. 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 địa điểm thuộc chuỗi cửa hàng theo thuộc tính địa điểm. Chỉ những vị trí chuỗi thuộc về 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, tức là không có bộ lọc nào trên trường này.

MapsLocationSet

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

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

object (MapsLocationInfo)

Bắt buộc. Danh sách thông tin vị trí trên Maps 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
}
Trường
placeId

string

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

BusinessProfileLocationGroup

Thông tin về nhóm địa điểm linh động trên Trang doanh nghiệp. Chỉ áp dụng nếu loại của 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)
  }
}
Trường
dynamicBusinessProfileLocationGroupFilter

object (DynamicBusinessProfileLocationGroupFilter)

Lọc các nhóm địa điểm động trên Trang doanh nghiệp.

DynamicBusinessProfileLocationGroupFilter

Biểu thị một bộ lọc về vị trí trên 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 đó sẽ được kết hợp với nhau bằng toán tử AND.

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

string

Dùng để lọc vị trí trên Trang doanh nghiệp theo nhãn. Chỉ những vị trí có bất kỳ nhãn nào trong danh sách mới được đưa vào nhóm thành phần. Các bộ lọc nhãn được kết hợp với nhau bằng toán tử OR.

listingIdFilters[]

string (int64 format)

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

businessNameFilter

object (BusinessProfileBusinessNameFilter)

Dùng để lọc địa điểm 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)
}
Trường
businessName

string

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

filterType

enum (LocationStringFilterType)

Kiểu so khớp chuỗi cần 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 chỉ định.
UNKNOWN Chỉ dùng cho giá trị trả về. Biểu thị giá trị không xác định trong phiên bản này.
EXACT Bộ lọc sẽ sử dụng kiểu so khớp chuỗi chính xác.

ChainLocationGroup

Biểu thị thông tin về một nhóm vị trí động của chuỗi cửa hàng. Chỉ áp dụng nếu loại của 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)
    }
  ]
}
Trường
dynamicChainLocationGroupFilters[]

object (ChainFilter)

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