AssetSet

Một tập hợp 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.
}
Trường
id

string (int64 format)

Chỉ có đầu ra. Mã của nhóm tài sả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à 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 nhóm thành phần chứa các phần tử của nhóm thành phần này. Ví dụ: mã vị trí cấp đồng bộ hoá AssetSet, 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 của 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 mục tiêu về du lịch có đường liên kết đến tài khoản Hotel Center. Chỉ đọc.

Trường hợp asset_set_source. Dữ liệu tập hợp 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:
locationSet

object (LocationSet)

Dữ liệu về nhóm thành phần địa điểm. Danh sách này sẽ được dùng cho quy trình thiết lập vị trí ở mức đồ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 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. Chỉ áp dụng nếu loại AssetSet của cấp đồng bộ là LOCATION_SYNC và nguồn đồng bộ hóa là chuỗi.

AssetSetStatus

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

Enum
UNSPECIFIED Trạng thái chưa được chỉ định.
UNKNOWN Phiên bản này không xác định giá trị đã nhận. Đây là giá trị chỉ phản hồi.
ENABLED Bộ 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
}
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ó đườ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
}
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 chế độ 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 gọi 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 địa điểm (địa điểm do đơn vị liên kết sở hữu hoặc địa điểm của đơn vị liên kết).

Trường hợp 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:
businessProfileLocationSet

object (BusinessProfileLocationSet)

Dữ liệu dùng để định cấu hình một nhóm vị trí được điền sẵ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 các vị trí được đồng bộ hoá dựa trên các vị trí đã chọn trên bản đồ

BusinessProfileLocationSet

Dữ liệu dùng để định cấu hình một nhóm vị trí được điền sẵ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, nếu chúng đượ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ã thông báo uỷ quyền HTTP được dùng để được cấp quyền.

emailAddress

string

Bắt buộc. Không thể thay đổi. Địa chỉ email của một 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 các trang thông tin trong Trang doanh nghiệp trên Google theo nhãn. Nếu các mục nhập tồn tại trong labelFilters, thì chỉ những trang thông tin đã đặt nhãn mới là đủ điều kiện để đồng bộ hóa với Thành phần. 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. 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 trang thông tin trong Trang doanh nghiệp trên Google theo mã trang thông tin. Nếu các mục tồn tại 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ả trang thông tin đều là ứng dụng để đồ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ì mọi 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 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 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.
AUTO_DEALERS Mối quan hệ của đại lý ô tô.
GENERAL_RETAILERS Mối quan hệ chung của 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 trong số 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í của chuỗi theo mã chuỗi. Chỉ các 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 các vị trí của chuỗi cửa hàng theo thuộc tính của vị trí. Chỉ các vị trí chuỗi thuộc tất cả(các) thuộc tính được chỉ định mới có trong bộ thành phần. Nếu trường này trống, điều đó có nghĩa là không lọc 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 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
}
Trường
placeId

string

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

BusinessProfileLocationGroup

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

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

object (DynamicBusinessProfileLocationGroupFilter)

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

DynamicBusinessProfileLocationGroupFilter

Biểu thị một bộ lọc trên 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 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)
  }
}
Trường
labelFilters[]

string

Dùng để lọc các vị trí trên Trang doanh nghiệp theo nhãn. Chỉ những địa điểm có nhãn được liệt kê mới có trong bộ 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ã nhận dạng trang thông tin.

businessNameFilter

object (BusinessProfileBusinessNameFilter)

Dùng để lọc các vị trí trong 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 để lọc.

filterType

enum (LocationStringFilterType)

Loại 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ề. Đạ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 kiểu khớp chuỗi chính xác.

ChainLocationGroup

Biểu thị thông tin về nhóm vị trí động của Chuỗi. Chỉ áp dụng nếu loại AssetSet của cấp đồng bộ là LOCATION_SYNC và nguồn đồng bộ hóa 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í của chuỗi theo mã chuỗi. Chỉ những Địa điểm thuộc(các) chuỗi được chỉ định mới có trong nhóm thành phần.