Package google.mybusiness.businessinformation.v1

Indeks

AttributesService

Memungkinkan klien mencari dan memperbarui atribut untuk lokasi tertentu.

GetAttributes

rpc GetAttributes(GetAttributesRequest) returns (Attributes)

Mencari semua atribut yang ditetapkan untuk lokasi tertentu.

Cakupan otorisasi

Memerlukan cakupan OAuth berikut ini:

  • https://www.googleapis.com/auth/business.manage

Untuk informasi selengkapnya, lihat Ringkasan OAuth 2.0.

GetGoogleUpdatedAttributes

rpc GetGoogleUpdatedAttributes(GetGoogleUpdatedAttributesRequest) returns (Attributes)

Mendapatkan versi yang diperbarui Google untuk lokasi yang ditentukan.

Cakupan otorisasi

Memerlukan cakupan OAuth berikut ini:

  • https://www.googleapis.com/auth/business.manage

Untuk informasi selengkapnya, lihat Ringkasan OAuth 2.0.

ListAttributeMetadata

rpc ListAttributeMetadata(ListAttributeMetadataRequest) returns (ListAttributeMetadataResponse)

Menampilkan daftar atribut yang akan tersedia untuk lokasi dengan kategori dan negara utama tertentu.

Cakupan otorisasi

Memerlukan cakupan OAuth berikut ini:

  • https://www.googleapis.com/auth/business.manage

Untuk informasi selengkapnya, lihat Ringkasan OAuth 2.0.

UpdateAttributes

rpc UpdateAttributes(UpdateAttributesRequest) returns (Attributes)

Memperbarui atribut untuk lokasi tertentu.

Cakupan otorisasi

Memerlukan cakupan OAuth berikut ini:

  • https://www.googleapis.com/auth/business.manage

Untuk informasi selengkapnya, lihat Ringkasan OAuth 2.0.

CategoriesService

API ini memberikan informasi tentang kategori yang didukung untuk lokasi bisnis di Google. Untuk mendapatkan referensi, lihat bagian kategori dalam artikel ini: https://support.google.com/business/answer/3038177

BatchGetCategories

rpc BatchGetCategories(BatchGetCategoriesRequest) returns (BatchGetCategoriesResponse)

Menampilkan daftar kategori bisnis untuk bahasa dan ID GConcept yang diberikan.

Cakupan otorisasi

Memerlukan cakupan OAuth berikut ini:

  • https://www.googleapis.com/auth/business.manage

Untuk informasi selengkapnya, lihat Ringkasan OAuth 2.0.

ListCategories

rpc ListCategories(ListCategoriesRequest) returns (ListCategoriesResponse)

Menampilkan daftar kategori bisnis. Penelusuran akan mencocokkan nama kategori, tetapi tidak dengan ID kategori.

Penelusuran hanya cocok dengan bagian depan nama kategori (yaitu, 'food' dapat menampilkan 'Food Court' tetapi bukan 'Fast Food Restaurant').

Cakupan otorisasi

Memerlukan cakupan OAuth berikut ini:

  • https://www.googleapis.com/auth/business.manage

Untuk informasi selengkapnya, lihat Ringkasan OAuth 2.0.

Rantai

Layanan untuk mencari informasi tentang bisnis Jaringan Bisnis.

GetChain

rpc GetChain(GetChainRequest) returns (Chain)

Mendapatkan rantai yang ditentukan. Menampilkan NOT_FOUND jika rantai tidak ada.

Cakupan otorisasi

Memerlukan cakupan OAuth berikut ini:

  • https://www.googleapis.com/auth/business.manage

Untuk informasi selengkapnya, lihat Ringkasan OAuth 2.0.

SearchChains

rpc SearchChains(SearchChainsRequest) returns (SearchChainsResponse)

Menelusuri jaringan berdasarkan nama jaringan bisnis.

Cakupan otorisasi

Memerlukan cakupan OAuth berikut ini:

  • https://www.googleapis.com/auth/business.manage

Untuk informasi selengkapnya, lihat Ringkasan OAuth 2.0.

GoogleLocations

API ini memungkinkan akses dan penelusuran GoogleLocation.

SearchGoogleLocations

rpc SearchGoogleLocations(SearchGoogleLocationsRequest) returns (SearchGoogleLocationsResponse)

Menelusuri semua kemungkinan lokasi yang cocok dengan permintaan yang ditentukan.

Cakupan otorisasi

Memerlukan cakupan OAuth berikut ini:

  • https://www.googleapis.com/auth/business.manage

Untuk informasi selengkapnya, lihat Ringkasan OAuth 2.0.

Lokasi

API ini memungkinkan pengelolaan lokasi bisnis di Google.

CreateLocation

rpc CreateLocation(CreateLocationRequest) returns (Location)

Membuat Lokasi baru yang akan dimiliki oleh pengguna yang login.

Cakupan otorisasi

Memerlukan cakupan OAuth berikut ini:

  • https://www.googleapis.com/auth/business.manage

Untuk informasi selengkapnya, lihat Ringkasan OAuth 2.0.

DeleteLocation

rpc DeleteLocation(DeleteLocationRequest) returns (Empty)

Menghapus lokasi.

Jika lokasi ini tidak dapat dihapus menggunakan API dan lokasi tersebut ditandai di google.mybusiness.businessinformation.v1.LocationState, gunakan situs Google Profil Bisnis.

Cakupan otorisasi

Memerlukan cakupan OAuth berikut ini:

  • https://www.googleapis.com/auth/business.manage

Untuk informasi selengkapnya, lihat Ringkasan OAuth 2.0.

GetGoogleUpdatedLocation

rpc GetGoogleUpdatedLocation(GetGoogleUpdatedLocationRequest) returns (GoogleUpdatedLocation)

Mendapatkan versi yang diperbarui Google untuk lokasi yang ditentukan.

Cakupan otorisasi

Memerlukan cakupan OAuth berikut ini:

  • https://www.googleapis.com/auth/business.manage

Untuk informasi selengkapnya, lihat Ringkasan OAuth 2.0.

GetLocation

rpc GetLocation(GetLocationRequest) returns (Location)

Menampilkan lokasi yang ditentukan.

Cakupan otorisasi

Memerlukan cakupan OAuth berikut ini:

  • https://www.googleapis.com/auth/business.manage

Untuk informasi selengkapnya, lihat Ringkasan OAuth 2.0.

ListLocations

rpc ListLocations(ListLocationsRequest) returns (ListLocationsResponse)

Menampilkan daftar lokasi untuk akun yang ditentukan.

Cakupan otorisasi

Memerlukan cakupan OAuth berikut ini:

  • https://www.googleapis.com/auth/business.manage

Untuk informasi selengkapnya, lihat Ringkasan OAuth 2.0.

UpdateLocation

rpc UpdateLocation(UpdateLocationRequest) returns (Location)

Memperbarui lokasi yang ditentukan.

Cakupan otorisasi

Memerlukan cakupan OAuth berikut ini:

  • https://www.googleapis.com/auth/business.manage

Untuk informasi selengkapnya, lihat Ringkasan OAuth 2.0.

AdWordsLocationExtensions

Informasi tambahan yang muncul di AdWords.

Kolom
ad_phone

string

Wajib. Nomor telepon alternatif yang akan ditampilkan di ekstensi lokasi AdWords, bukan nomor telepon utama lokasi.

Atribut

Atribut lokasi. Atribut memberikan informasi tambahan tentang lokasi. Atribut yang dapat ditetapkan pada lokasi dapat bervariasi berdasarkan properti lokasi tersebut (misalnya, kategori). Atribut yang tersedia ditentukan oleh Google serta dapat ditambahkan dan dihapus tanpa perubahan API.

Kolom
name

string

Wajib. Nama resource untuk atribut ini.

value_type

AttributeValueType

Hanya output. Jenis nilai yang terdapat dalam atribut ini. Nilai ini harus digunakan untuk menentukan cara menafsirkan nilai.

values[]

Value

Nilai untuk atribut ini. Jenis nilai yang diberikan harus cocok dengan yang diharapkan untuk atribut tersebut. Ini adalah kolom berulang tempat beberapa nilai atribut dapat diberikan. Jenis atribut hanya mendukung satu nilai.

repeated_enum_value

RepeatedEnumAttributeValue

Jika jenis nilai atribut adalah REPEATED_ENUM, kolom ini berisi nilai atribut, dan kolom nilai lainnya harus kosong.

uri_values[]

UriAttributeValue

Jika jenis nilai atribut adalah URL, kolom ini berisi nilai untuk atribut ini, dan kolom nilai lainnya harus kosong.

AttributeMetadata

Metadata untuk atribut. Berisi informasi tampilan untuk atribut, termasuk nama yang dilokalkan dan judul untuk mengelompokkan atribut terkait menjadi satu.

Kolom
parent

string

ID unik untuk atribut.

value_type

AttributeValueType

Jenis nilai untuk atribut. Nilai yang ditetapkan dan diambil diharapkan dari jenis ini.

display_name

string

Nama tampilan yang dilokalkan untuk atribut, jika tersedia; jika tidak, nama tampilan bahasa Inggris.

group_display_name

string

Nama tampilan grup yang dilokalkan yang berisi atribut ini, jika tersedia; jika tidak, nama grup bahasa Inggris. Atribut terkait dikumpulkan ke dalam grup dan harus ditampilkan bersamaan di bawah judul yang diberikan di sini.

repeatable

bool

Jika true (benar), atribut mendukung beberapa nilai. Jika salah, hanya satu nilai yang harus diberikan.

value_metadata[]

AttributeValueMetadata

Untuk beberapa jenis atribut (misalnya, enum), daftar nilai yang didukung dan nama tampilan yang sesuai untuk nilai tersebut akan diberikan.

deprecated

bool

Jika true (benar), atribut tidak akan digunakan lagi dan seharusnya tidak digunakan lagi. Jika tidak digunakan lagi, memperbarui atribut ini tidak akan menghasilkan error, tetapi pembaruan tidak akan disimpan. Pada titik tertentu setelah tidak digunakan lagi, atribut akan dihapus sepenuhnya dan akan menjadi error.

AttributeValueMetadata

Metadata untuk nilai atribut yang didukung.

Kolom
value

Value

Nilai atribut.

display_name

string

Nama tampilan untuk nilai ini, dilokalkan jika tersedia; jika tidak, dalam bahasa Inggris. Nama tampilan nilai dimaksudkan untuk digunakan dalam konteks dengan nama tampilan atribut.

Misalnya, untuk atribut enum "Wi-Fi", atribut ini dapat berisi "Berbayar" untuk mewakili Wi-Fi berbayar.

AttributeValueType

Jenis nilai atribut.

Enum
ATTRIBUTE_VALUE_TYPE_UNSPECIFIED Tidak ditentukan.
BOOL Nilai untuk atribut ini adalah nilai boolean.
ENUM Atribut memiliki daftar nilai tersedia yang telah ditentukan yang dapat digunakan. Metadata untuk atribut ini akan mencantumkan nilai-nilai ini.
URL Nilai untuk atribut ini adalah URL.
REPEATED_ENUM Nilai atribut adalah enum dengan beberapa nilai kemungkinan yang dapat secara eksplisit ditetapkan atau tidak ditetapkan.

Atribut

Container bagi semua atribut untuk lokasi tertentu.

Kolom
name

string

Wajib. ID Google untuk lokasi ini dalam bentuk locations/{location_id}/attributes.

attributes[]

Attribute

Kumpulan atribut yang perlu diperbarui.

BatchGetCategoriesRequest

Pesan permintaan untuk BusinessCategory.BatchGetBusinessCategory.

Kolom
names[]

string

Wajib. Minimal satu nama harus ditetapkan. ID GConcept yang menjadi tujuan ditampilkannya nama kategori yang dilokalkan. Guna menampilkan detail untuk lebih dari satu kategori, ulangi parameter ini dalam permintaan.

language_code

string

Wajib. Kode bahasa BCP 47 tempat nama kategori harus ditampilkan.

region_code

string

Opsional. Kode negara ISO 3166-1 alpha-2 yang digunakan untuk menyimpulkan bahasa non-standar.

view

CategoryView

Wajib. Menentukan bagian mana ke resource Kategori yang harus ditampilkan dalam respons.

BatchGetCategoriesResponse

Pesan respons untuk BusinessCategory.BatchGetBusinessCategory.

Kolom
categories[]

Category

Kategori yang cocok dengan id GConcept yang diberikan dalam permintaan. ID kategori tidak akan berada dalam urutan yang sama dengan ID kategori dalam permintaan.

BusinessHours

Merepresentasikan jangka waktu saat lokasi ini buka. Menyimpan kumpulan instance [TimePeriod][google.mybusiness.mybusinessinformation.v1.TimePeriod].

Kolom
periods[]

TimePeriod

Wajib. Kumpulan waktu saat lokasi ini buka. Setiap periode mewakili rentang jam saat lokasi buka selama seminggu.

Kategori

Kumpulan kategori yang mendeskripsikan bisnis. Selama update, kedua kolom harus ditetapkan. Klien dilarang memperbarui kategori utama atau tambahan satu per satu menggunakan mask pembaruan.

Kolom
primary_category

Category

Wajib. Kategori yang paling menggambarkan bisnis inti yang dilakukan lokasi ini.

additional_categories[]

Category

Opsional. Kategori tambahan untuk mendeskripsikan bisnis Anda. Kategori membantu pelanggan menemukan hasil yang spesifik dan akurat untuk layanan yang mereka minati. Untuk menjaga informasi bisnis tetap akurat dan aktif, pastikan Anda menggunakan sesedikit mungkin kategori untuk mendeskripsikan bisnis inti Anda secara keseluruhan. Pilih kategori yang sespesifik mungkin, tetapi merepresentasikan bisnis utama Anda.

Kategori

Kategori yang mendeskripsikan jenis bisnis ini (bukan apa yang dilakukannya). Untuk daftar ID kategori yang valid, dan pemetaan ke nama yang dapat dibaca manusia, lihat categories.list.

Kolom
name

string

Wajib. ID stabil (disediakan oleh Google) untuk kategori ini. Nilai harus ditentukan saat memodifikasi kategori (saat membuat atau memperbarui lokasi).

display_name

string

Hanya output. Nama kategori yang dapat dibaca manusia. Ini ditetapkan saat membaca lokasi. Saat mengubah lokasi, category_id harus ditetapkan.

service_types[]

ServiceType

Hanya output. Daftar semua jenis layanan yang tersedia untuk kategori bisnis ini.

more_hours_types[]

MoreHoursType

Hanya output. Jenis jam buka lainnya yang tersedia untuk kategori bisnis ini.

CategoryView

Enum untuk membantu membatasi jumlah data yang ditampilkan oleh server.

Enum
CATEGORY_VIEW_UNSPECIFIED Tidak ditentukan, setara dengan CATEGORY_METADATA_ONLY.
BASIC Respons server hanya akan menyertakan kolom Kategori display_name, category_id, dan language_code. Ini menghilangkan kolom terkait metadata jenis layanan apa pun.
FULL Menampilkan semua kolom dalam respons.

Chain

Rantai adalah merek yang dapat berafiliasi dengan lokasi bisnis Anda.

Kolom
name

string

Wajib. Nama resource rantai, dalam format chains/{chain_id}.

chain_names[]

ChainName

Nama rantai.

websites[]

ChainUri

Situs jaringan bisnis tersebut.

location_count

int32

Jumlah lokasi yang merupakan bagian dari rantai ini.

ChainName

Nama yang akan digunakan saat menampilkan rantai.

Kolom
display_name

string

Nama tampilan untuk rantai ini.

language_code

string

Kode bahasa nama BCP 47.

ChainUri

URL yang akan digunakan saat menampilkan rantai.

Kolom
uri

string

URI untuk rantai ini.

CreateLocationRequest

Pesan permintaan untuk locations.CreateLocation.

Kolom
parent

string

Wajib. Nama akun untuk membuat lokasi ini.

location

Location

Wajib. Metadata lokasi baru.

validate_only

bool

Opsional. Jika benar, permintaan divalidasi tanpa benar-benar membuat lokasi.

request_id

string

Opsional. ID permintaan unik untuk server guna mendeteksi permintaan duplikat. Sebaiknya gunakan UUID. Panjang maksimal adalah 50 karakter.

DeleteLocationRequest

Pesan permintaan untuk locations.DeleteLocation.

Kolom
name

string

Wajib. Nama lokasi yang akan dihapus.

ErrorCode

Semua kode error yang ditampilkan oleh API.

Enum
ERROR_CODE_UNSPECIFIED Kode error tidak ada.
INVALID_ATTRIBUTE_NAME Salah satu atribut yang diberikan tidak dapat diterapkan ke lokasi ini. Hanya atribut yang ditampilkan dalam respons ListAttributeMetadata yang dapat diterapkan ke lokasi ini. Semua nama atribut yang bermasalah akan ditampilkan di kunci attribute_names di bagian metadata.
ASSOCIATE_OPERATION_ON_VERIFIED_LOCATION Error ini ditampilkan saat klien mencoba mengaitkan lokasi atau menghapus atribusi lokasi pada lokasi yang memiliki status terverifikasi.
ASSOCIATE_LOCATION_INVALID_PLACE_ID place_id yang diberikan dalam permintaan associateLocation tidak cocok dengan lokasi atau tidak valid. Pastikan place_id yang ditetapkan cocok dengan salah satu ID yang ditampilkan dalam respons SearchGoogleLocations.
LAT_LNG_UPDATES_NOT_PERMITTED Project ini tidak diizinkan untuk memperbarui kolom lintang/bujur pada Lokasi. Anda dapat memperbarui lintang/bujur menggunakan fungsi pelepasan pin di UI atau memberikan alamat kepada kami.
PO_BOX_IN_ADDRESS_NOT_ALLOWED PO box tidak dapat digunakan di alamat. Kunci metadata mencakup "field_mask".
BLOCKED_REGION Karena adanya sanksi internasional yang wajib kami patuhi, kami tidak dapat menerima bisnis dari wilayah ini. Kunci metadata mencakup "field_maks".
MISSING_BOTH_PHONE_AND_WEBSITE Telepon atau situs web diperlukan untuk bisnis CUSTOMER_LOCATION_ONLY. Kunci metadata mencakup "field_mask".
MISSING_STOREFRONT_ADDRESS_OR_SAB Semua Lokasi harus memiliki setidaknya alamat etalase atau area layanan. Kunci metadata mencakup "field_mask".
LAT_LNG_TOO_FAR_FROM_ADDRESS Pasangan lintang/bujur dan alamat terlalu jauh. Kunci metadata mencakup "field_mask".
LAT_LNG_REQUIRED TIDAK DIGUNAKAN LAGI. Diganti dengan PIN_DROP_REQUIRED. Alamat yang ditentukan tidak dapat ditemukan. Berikan lintang/bujur. Kunci metadata mencakup "field_mask".
INVALID_CHARACTERS Ditemukan karakter yang tidak valid. Kunci metadata mencakup "field_mask" dan "invalid_characters".
FORBIDDEN_WORDS Ditemukan kata-kata yang dilarang. Kunci metadata mencakup "field_mask" dan "forbidden_words".
INVALID_INTERCHANGE_CHARACTERS Ditemukan karakter yang tidak valid. Kunci metadata mencakup "field_mask".
FIELDS_REQUIRED_FOR_CATEGORY Kolom tambahan diperlukan untuk kategori lokasi ini. Kunci metadata mencakup "field_mask", "value", dan "fields_required".
STOREFRONT_REQUIRED_FOR_CATEGORY Kategori bisnis Anda memerlukan lokasi etalase yang dapat dikunjungi pelanggan. Kunci metadata mencakup "field_mask".
ADDRESS_MISSING_REGION_CODE Alamat tidak memiliki region_code wajib. Kunci metadata mencakup "field_mask".
ADDRESS_EDIT_CHANGES_COUNTRY Alamat tidak dapat dipindahkan ke negara lain. Kunci metadata mencakup "field_mask".
SPECIAL_HOURS_SET_WITHOUT_REGULAR_HOURS Jam khusus hanya dapat ditentukan jika lokasi tersebut memiliki jam buka reguler. Metadata kosong.
INVALID_TIME_SCHEDULE Jadwal waktu tidak valid, waktu tumpang-tindih, atau waktu berakhir lebih awal dari waktu mulai. Kunci metadata mencakup "field_mask".
INVALID_HOURS_VALUE Format atau nilai jam tidak valid. Kunci metadata mencakup "field_mask".
OVERLAPPED_SPECIAL_HOURS Special_hours tidak boleh tumpang-tindih. Kunci metadata mencakup "field_mask".
INCOMPATIBLE_MORE_HOURS_TYPE_FOR_CATEGORY Kategori utama bisnis Anda tidak mendukung jenis jam buka ini. Kunci metadata mencakup "field_mask" dan "incompatible_hours_type".
DUPLICATE_CHILDREN_LOCATIONS Children_locations duplikat di connection_data. Kunci metadata mencakup "field_mask".
INCOMPATIBLE_SERVICE_AREA_AND_CATEGORY Bisnis jasa sistem panggilan tidak boleh memiliki kategori utama yang dipilih. Kunci metadata mencakup "field_mask".
INVALID_SERVICE_AREA_PLACE_ID Place_id di service_area tidak valid. Kunci metadata mencakup "field_mask" dan "place_id".
INVALID_AREA_TYPE_FOR_SERVICE_AREA Jenis area untuk service_area tidak valid. Kunci metadata mencakup "field_mask" dan "place_id".
OPENING_DATE_TOO_FAR_IN_THE_FUTURE Masukkan tanggal buka yang jatuh dalam rentang satu tahun. Kunci metadata mencakup "field_mask".
OPENING_DATE_MISSING_YEAR_OR_MONTH Tanggal buka harus memiliki tahun atau bulan yang ditentukan. Kunci metadata mencakup "field_mask".
OPENING_DATE_BEFORE_1AD Tanggal buka tidak boleh sebelum 1 M. Kunci metadata mencakup "field_mask".
TOO_MANY_ENTRIES Terlalu banyak entri untuk kolom. Kunci metadata mencakup "field_mask" dan "max_count".
INVALID_PHONE_NUMBER Input nomor telepon tidak dikenal. Kunci metadata mencakup "field_mask" dan "value".
INVALID_PHONE_NUMBER_FOR_REGION Nomor telepon tidak valid untuk wilayah. Kunci metadata mencakup "field_mask" dan "value".
MISSING_PRIMARY_PHONE_NUMBER Nomor telepon utama tidak ada. Kunci metadata mencakup "field_mask".
THROTTLED Kolom saat ini tidak dapat diperbarui. Kunci metadata mencakup "field_mask" dan "value".
UNSUPPORTED_POINT_RADIUS_SERVICE_AREA Area layanan radius titik tidak lagi didukung. Kunci metadata mencakup "field_mask".
INVALID_CATEGORY ID kategori tidak valid. Kunci metadata mencakup "field_mask" dan "value".
CANNOT_REOPEN Bisnis tidak dapat dibuka kembali. Kunci metadata mencakup "field_mask".
INVALID_BUSINESS_OPENING_DATE Tanggal buka bisnis tidak valid. Kunci metadata mencakup "field_mask".
INVALID_LATLNG Lalatlng tidak valid. Kunci metadata mencakup "field_mask".
PROFILE_DESCRIPTION_CONTAINS_URL Deskripsi bisnis tidak boleh berisi URL. Kunci metadata mencakup "field_mask".
LODGING_CANNOT_EDIT_PROFILE_DESCRIPTION Deskripsi profil lokasi penginapan tidak dapat diedit. Kunci metadata mencakup "field_mask".
INVALID_URL Tautan tidak valid. Kunci metadata mencakup "field_mask".
INVALID_ADDRESS Alamat tidak valid. Kunci metadata mencakup "field_mask".
PARENT_CHAIN_CANNOT_BE_THE_LOCATION_ITSELF ParentChain tidak boleh berupa lokasi itu sendiri. Kunci metadata mencakup "field_mask" dan "value".
RELATION_CANNOT_BE_THE_LOCATION_ITSELF Relasi tidak boleh berupa lokasi itu sendiri. Kunci metadata mencakup "field_mask" dan "value".
MISSING_ADDRESS_COMPONENTS Nilai untuk komponen alamat tidak ada. Kunci metadata mencakup "field_mask".
READ_ONLY_ADDRESS_COMPONENTS Tidak dapat mengedit komponen alamat hanya baca. Kunci metadata mencakup "field_mask".
STRING_TOO_LONG String terlalu panjang. Kunci metadata mencakup "field_mask" dan "max_length".
STRING_TOO_SHORT String terlalu pendek. Kunci metadata mencakup "field_mask" dan "min_length".
REQUIRED_FIELD_MISSING_VALUE Nilai untuk bidang wajib belum diisi. Kunci metadata mencakup "field_mask".
ATTRIBUTE_PROVIDER_URL_NOT_ALLOWED URL untuk penyedia tidak dapat ditambahkan atau diedit. Kunci metadata menyertakan "attribute_name".
ATTRIBUTE_INVALID_ENUM_VALUE Nilai untuk atribut enum tidak diketahui. Kunci metadata menyertakan "attribute_name".
ATTRIBUTE_NOT_AVAILABLE Atribut skalabel tidak valid untuk lokasi ini. Kunci metadata menyertakan ""attribute_name".
ATTRIBUTE_CANNOT_BE_REPEATED Atribut skalabel hanya ditentukan sekali. Kunci metadata menyertakan "attribute_name".
ATTRIBUTE_TYPE_NOT_COMPATIBLE_FOR_CATEGORY Atribut skalabel tidak kompatibel dengan kategori yang ditetapkan pada lokasi. Kunci metadata menyertakan "attribute_name".
ADDRESS_REMOVAL_NOT_ALLOWED Penghapusan alamat tidak diizinkan untuk bisnis Anda. Kunci metadata mencakup "field_mask".
AMBIGUOUS_TITLE Nama terbaik bersifat ambigu untuk suatu bahasa. Kunci metadata mencakup "field_mask".
INVALID_CATEGORY_FOR_SAB SAB murni tidak dapat memiliki gcid yang merupakan subjenis gcid:stitution_poi. Kunci metadata mencakup "field_mask" dan "value".
RELATION_ENDPOINTS_TOO_FAR Endpoint hubungan terlalu jauh satu sama lain. Kunci metadata mencakup "field_mask" dan "value".
INVALID_SERVICE_ITEM Terstruktur_service_item atau free_form_service_item tidak ditetapkan. Kunci metadata mencakup "field_mask".
SERVICE_ITEM_LABEL_NO_DISPLAY_NAME Label tidak memiliki nama tampilan. Kunci metadata mencakup "field_mask".
SERVICE_ITEM_LABEL_DUPLICATE_DISPLAY_NAME Nama tampilan tidak unik untuk semua label di semua daftar harga. Kunci metadata mencakup "field_mask".
SERVICE_ITEM_LABEL_INVALID_UTF8 Label berisi simbol UTF-8 yang tidak valid. Kunci metadata mencakup "field_mask".
FREE_FORM_SERVICE_ITEM_WITH_NO_CATEGORY_ID Kolom category_id tidak ada di free_form_service_item. Kunci metadata mencakup "field_mask".
FREE_FORM_SERVICE_ITEM_WITH_NO_LABEL Label tidak ada di free_form_service_item. Kunci metadata mencakup "field_mask".
SERVICE_ITEM_WITH_NO_SERVICE_TYPE_ID Kolom service_type_id tidak ada di structured_service_item. Kunci metadata mencakup "field_mask".
INVALID_LANGUAGE Kode bahasa tidak valid. Kunci metadata mencakup "field_mask".
PRICE_CURRENCY_MISSING Kode mata uang ISO 4217 tidak ada. Kunci metadata mencakup "field_mask".
PRICE_CURRENCY_INVALID Kode mata uang yang diberikan bukan ISO 4217 yang valid. Kunci metadata mencakup "field_mask".
SERVICE_TYPE_ID_DUPLICATE ID jenis layanan tidak unik dalam Lokasi. Kunci metadata mencakup "field_mask".
PIN_DROP_REQUIRED Alamat yang ditentukan tidak dapat ditemukan. Gunakan UI untuk memberikan pelepasan pin. Kunci metadata mencakup "field_mask".
STALE_DATA Satu atau beberapa item baru saja diperbarui oleh Google. Hanya pemilik bisnis ini yang dapat mengubah data yang berada di "kolom" saat ini dengan mengunjungi business.google.com. Kunci metadata menyertakan "field_mask".
PHONE_NUMBER_EDITS_NOT_ALLOWED Bidang nomor telepon telah dinonaktifkan untuk lokasi ini dan pengeditan tidak diizinkan. Kunci metadata mencakup "field_mask".
MULTIPLE_ORGANIZATIONALLY_PART_OF_RELATION Ada lebih dari satu relasi yang memodelkan hubungan logis antara dua lokasi (mis. deperatment dari, bekerja di). Kunci metadata mencakup "field_mask" dan "value".

GetAttributesRequest

Permintaan untuk AttributesService.GetAttributes.

Kolom
name

string

Wajib. ID Google untuk lokasi ini dalam bentuk locations/{location_id}/attributes.

GetChainRequest

Pesan permintaan untukLocations.GetChain.

Kolom
name

string

Wajib. Nama resource rantai, dalam format chains/{chain_place_id}.

GetGoogleUpdatedAttributesRequest

Permintaan untuk AttributesService.GetGoogleUpdatedAttributes.

Kolom
name

string

Wajib. ID Google untuk lokasi ini dalam bentuk locations/{location_id}/attributes.

GetGoogleUpdatedLocationRequest

Pesan permintaan untuk locations.GetGoogleUpdatedLocation.

Kolom
name

string

Wajib. Nama lokasi yang akan diambil.

read_mask

FieldMask

Wajib. Read mask untuk menentukan kolom yang akan ditampilkan dalam respons.

GetLocationRequest

Pesan permintaan untuk Locations.GetLocation.

Kolom
name

string

Wajib. Nama lokasi yang akan diambil.

read_mask

FieldMask

Wajib. Read mask untuk menentukan kolom yang akan ditampilkan dalam respons.

GoogleLocation

Merepresentasikan Location yang ada di Google. Lokasi dapat berupa lokasi yang diklaim oleh pengguna, orang lain, atau dapat dibatalkan klaimnya.

Kolom
name

string

Nama resource GoogleLocation ini, dalam format googleLocations/{googleLocationId}.

location

Location

Informasi Location yang sedikit diisi. Kolom ini dapat digunakan kembali di CreateLocation jika saat ini tidak diklaim oleh pengguna.

request_admin_rights_uri

string

URL yang akan mengalihkan pengguna ke UI hak admin permintaan. Kolom ini hanya ada jika lokasi telah diklaim oleh pengguna mana pun, termasuk pengguna saat ini.

GoogleUpdatedLocation

Merepresentasikan lokasi yang diubah oleh Google.

Kolom
location

Location

Versi yang diperbarui Google untuk lokasi ini.

diff_mask

FieldMask

Kolom yang diperbarui Google.

pending_mask

FieldMask

Kolom dengan hasil edit tertunda yang belum dikirim ke Maps dan Penelusuran.

Label

Label yang akan digunakan saat menampilkan daftar harga, bagian, atau item.

Kolom
display_name

string

Wajib. Nama tampilan untuk daftar harga, bagian, atau item.

description

string

Opsional. Deskripsi daftar harga, bagian, atau item.

language_code

string

Opsional. Kode bahasa BCP-47 yang berlaku untuk string ini. Hanya satu kumpulan label yang dapat ditetapkan per bahasa.

ListAttributeMetadataRequest

Permintaan untuk AttributesService.ListAttributeMetadata.

Kolom
parent

string

Nama resource lokasi untuk mencari atribut yang tersedia. Jika kolom ini ditetapkan, category_name, region_code, language_code, dan show_all tidak diperlukan dan tidak boleh disetel.

category_name

string

ID stabil kategori utama untuk menemukan atribut yang tersedia. Harus dalam format kategori/{category_id}.

region_code

string

Kode negara ISO 3166-1 alpha-2 untuk menemukan atribut yang tersedia.

language_code

string

Kode bahasa BCP 47 untuk mendapatkan nama tampilan atribut. Jika bahasa ini tidak tersedia, sertifikat akan diberikan dalam bahasa Inggris.

show_all

bool

Metadata untuk semua atribut yang tersedia ditampilkan jika kolom ini disetel ke benar (true), dengan mengabaikan kolom induk dan category_name. language_code dan region_code diperlukan jika show_all disetel ke true.

page_size

int32

Berapa banyak atribut yang akan disertakan per halaman. Defaultnya adalah 200, minimumnya 1.

page_token

string

Jika ditentukan, halaman metadata atribut berikutnya akan diambil.

ListAttributeMetadataResponse

Respons untuk AttributesService.ListAttributeMetadata.

Kolom
attribute_metadata[]

AttributeMetadata

Kumpulan metadata atribut untuk atribut yang tersedia.

next_page_token

string

Jika jumlah atribut melebihi ukuran halaman yang diminta, kolom ini akan diisi dengan token untuk mengambil halaman atribut berikutnya pada panggilan selanjutnya ke attributes.list. Jika tidak ada atribut lagi, kolom ini tidak akan ada dalam respons.

ListCategoriesRequest

Pesan permintaan untuk BusinessCategory.ListCategory.

Kolom
region_code

string

Wajib. Kode negara ISO 3166-1 alpha-2.

language_code

string

Wajib. Kode bahasa BCP 47.

filter

string

Opsional. Filter string dari pengguna. Satu-satunya kolom yang didukung adalah displayName. Misalnya: filter=displayName=foo.

page_size

int32

Opsional. Berapa banyak kategori yang harus diambil per halaman. Ukuran halaman default adalah 100, minimum 1, dan maksimum 100.

page_token

string

Opsional. Jika ditentukan, halaman kategori berikutnya akan diambil.

view

CategoryView

Wajib. Menentukan bagian mana ke resource Kategori yang harus ditampilkan dalam respons.

ListCategoriesResponse

Pesan respons untuk BusinessCategory.ListCategory.

Kolom
categories[]

Category

Kategori pencocokan berdasarkan parameter yang diminta.

next_page_token

string

Jika jumlah kategori melebihi ukuran halaman yang diminta, kolom ini akan diisi dengan token untuk mengambil halaman kategori berikutnya pada panggilan selanjutnya ke ListCategories.

ListLocationsRequest

Pesan permintaan untukLocations.ListLocations.

Kolom
parent

string

Wajib. Nama akun yang lokasinya akan diambil. Jika [Akun] [google.mybusiness.accountmanagement.v1.Account] induk adalah [AccountType] [google.mybusiness.accountmanagement.v1.Account.AccountType] PERSONAL, hanya Lokasi yang secara langsung dimiliki oleh Akun yang ditampilkan, jika tidak, semua lokasi yang dapat diakses dari Akun akan ditampilkan, baik secara langsung maupun tidak langsung.

page_size

int32

Opsional. Berapa banyak lokasi yang akan diambil per halaman. Nilai defaultnya adalah 10 jika tidak ditetapkan. Ukuran halaman minimum adalah 1, dan maksimum 100.

page_token

string

Opsional. Jika ditentukan, metode ini akan mengambil page lokasi berikutnya. Token halaman ditampilkan oleh panggilan sebelumnya ke ListLocations jika ada lebih banyak lokasi daripada yang dapat ditampung dalam ukuran halaman yang diminta.

filter

string

Opsional. Filter yang membatasi lokasi yang akan ditampilkan. Responsnya hanya menyertakan entri yang cocok dengan filter. Jika filter kosong, maka batasan akan diterapkan dan semua lokasi (dengan penomoran halaman) diambil untuk akun yang diminta.

Untuk informasi selengkapnya tentang kolom valid dan contoh penggunaan, lihat Menggunakan Panduan Data Lokasi.

order_by

string

Opsional. Urutan penyortiran untuk permintaan. Beberapa {i>field<i} harus dipisahkan dengan tanda koma, sesuai dengan sintaks SQL. Urutan penyortiran {i>default<i} adalah menaik. Untuk menentukan urutan menurun, akhiran "desc" harus ditambahkan. Kolom yang valid untuk order_by adalah title [judul] dan store_code [kode_toko]. Misalnya: "title, store_code desc" atau "title" atau "store_code desc"

read_mask

FieldMask

Wajib. Read mask untuk menentukan kolom yang akan ditampilkan dalam respons.

ListLocationsResponse

Pesan respons untuk locations.ListLocations.

Kolom
locations[]

Location

Lokasi.

next_page_token

string

Jika jumlah lokasi melebihi ukuran halaman yang diminta, kolom ini diisi dengan token untuk mengambil halaman lokasi berikutnya pada panggilan selanjutnya ke ListLocations. Jika tidak ada lagi lokasi, kolom ini tidak ada dalam respons.

total_size

int32

Perkiraan jumlah Lokasi dalam daftar terlepas dari penomoran halaman. Kolom ini hanya akan ditampilkan jika filter digunakan sebagai parameter kueri.

Lokasi

Lokasi. Lihat artikel pusat bantuan untuk deskripsi mendetail tentang kolom tersebut atau endpoint kategori untuk daftar kategori bisnis yang valid.

Kolom
name

string

ID Google untuk lokasi ini dalam bentuk: locations/{location_id}.

language_code

string

Tidak dapat diubah. Bahasa lokasi. Ditetapkan selama pembuatan dan tidak dapat diperbarui.

store_code

string

Opsional. ID eksternal untuk lokasi ini, yang harus unik dalam akun tertentu. Ini adalah cara untuk mengaitkan lokasi dengan catatan Anda sendiri.

title

string

Wajib. Nama lokasi harus mencerminkan nama bisnis Anda yang sebenarnya, seperti yang digunakan secara konsisten di etalase, situs, alat tulis, dan sebagaimana diketahui pelanggan. Setiap informasi tambahan, jika relevan, dapat disertakan di kolom resource lainnya (misalnya, Address, Categories). Jangan tambahkan informasi yang tidak perlu ke nama Anda (misalnya, pilih "Google" daripada "Google Inc. - Mountain View Corporate Headquarters"). Jangan sertakan tagline pemasaran, kode toko, karakter khusus, jam buka atau status tutup/buka, nomor telepon, URL situs, informasi layanan/produk, lokasi/alamat atau rute, atau informasi tempat bisnis Anda berada (misalnya, "ATM Bank Mandiri di Jakarta Pusat").

phone_numbers

PhoneNumbers

Opsional. Berbagai nomor telepon yang dapat digunakan pelanggan untuk menghubungi bisnis.

categories

Categories

Opsional. Berbagai kategori yang mendeskripsikan bisnis.

storefront_address

PostalAddress

Opsional. Alamat yang tepat dan akurat untuk mendeskripsikan lokasi bisnis Anda. PO box atau kotak surat yang terletak di lokasi terpencil tidak dapat diterima. Saat ini, Anda dapat menentukan maksimum lima nilai address_lines di alamat. Kolom ini hanya boleh ditetapkan untuk bisnis yang memiliki etalase. Kolom ini tidak boleh disetel untuk lokasi jenis CUSTOMER_LOCATION_ONLY, tetapi jika disetel, nilai apa pun yang disediakan akan dihapus.

website_uri

string

Opsional. URL untuk bisnis ini. Jika memungkinkan, gunakan URL yang mewakili lokasi bisnis individual ini, bukan situs/URL umum yang mewakili semua lokasi, atau merek.

regular_hours

BusinessHours

Opsional. Jam operasional bisnis.

special_hours

SpecialHours

Opsional. Jam khusus untuk bisnis. Jam ini biasanya mencakup jam buka di hari libur, dan waktu lain di luar jam operasional reguler. Jam ini akan menggantikan jam buka reguler. Kolom ini tidak dapat ditetapkan tanpa jam buka reguler.

service_area

ServiceAreaBusiness

Opsional. Bisnis jasa sistem panggilan menyediakan layanan di lokasi pelanggan. Jika bisnis ini adalah bisnis jasa sistem panggilan, kolom ini mendeskripsikan area yang dilayani oleh bisnis tersebut.

labels[]

string

Opsional. Kumpulan string bentuk bebas yang memungkinkan Anda memberi tag pada bisnis Anda. Label ini TIDAK ditampilkan kepada pengguna; hanya Anda yang dapat melihatnya. Harus berisi antara 1-255 karakter per label.

ad_words_location_extensions

AdWordsLocationExtensions

Opsional. Informasi tambahan yang muncul di AdWords.

latlng

LatLng

Opsional. Lintang dan bujur yang diberikan pengguna. Saat membuat lokasi, kolom ini diabaikan jika alamat yang diberikan berhasil di-geocode. Kolom ini hanya ditampilkan menggunakan permintaan GET jika nilai latlng yang diberikan pengguna disetujui selama pembuatan, atau nilai latlng diperbarui melalui situs Google Profil Bisnis. Kolom ini hanya dapat diperbarui oleh klien yang disetujui.

open_info

OpenInfo

Opsional. Tanda yang menunjukkan apakah lokasi saat ini buka atau tidak.

metadata

Metadata

Hanya output. Informasi tambahan yang tidak dapat diedit pengguna.

profile

Profile

Opsional. Mendeskripsikan bisnis Anda dengan gaya Anda sendiri dan membagikan kisah unik tentang bisnis dan penawaran Anda kepada pengguna.

Kolom ini wajib diisi untuk semua kategori kecuali kategori penginapan (mis. hotel, motel, losmen).

relationship_data

RelationshipData

Opsional. Semua lokasi dan jaringan bisnis yang terkait dengan lokasi ini.

more_hours[]

MoreHours

Opsional. Jam buka lebih banyak untuk departemen yang berbeda atau pelanggan tertentu dalam sebuah bisnis.

service_items[]

ServiceItem

Opsional. Daftar layanan yang didukung oleh penjual. Layanan dapat memotong rambut, memasang pemanas air, dll. Item layanan duplikat akan dihapus secara otomatis.

Metadata

Informasi tambahan yang tidak dapat diedit pengguna tentang lokasi.

Kolom
has_google_updated

bool

Hanya output. Menunjukkan apakah ID tempat yang dikaitkan dengan lokasi ini memiliki pembaruan yang perlu diperbarui atau ditolak oleh klien. Jika boolean ini ditetapkan, Anda harus memanggil metode getGoogleUpdated untuk mencari informasi yang perlu diverifikasi.

has_pending_edits

bool

Hanya output. Menunjukkan apakah salah satu properti Lokasi ini berada dalam status hasil edit menunggu keputusan.

can_delete

bool

Hanya output. Menunjukkan apakah lokasi dapat dihapus menggunakan API.

can_operate_local_post

bool

Hanya output. Menunjukkan apakah listingan dapat mengelola postingan lokal.

can_modify_service_list

bool

Hanya output. Menunjukkan apakah listingan dapat mengubah daftar layanan.

can_have_food_menus

bool

Hanya output. Menunjukkan apakah listingan memenuhi syarat untuk menu makanan.

can_operate_health_data

bool

Hanya output. Menunjukkan apakah lokasi dapat beroperasi pada data Kesehatan.

can_operate_lodging_data

bool

Hanya output. Menunjukkan apakah lokasi dapat beroperasi pada data Penginapan.

place_id

string

Hanya output. Jika lokasi ini muncul di Google Maps, kolom ini akan diisi dengan ID tempat untuk lokasi tersebut. ID ini dapat digunakan di berbagai Places API.

Kolom ini dapat ditetapkan selama panggilan Create, tetapi tidak untuk Update.

duplicate_location

string

Hanya output. Resource lokasi yang diduplikasi lokasi ini.

maps_uri

string

Hanya output. Link ke lokasi di Maps.

new_review_uri

string

Hanya output. Link ke halaman di Google Penelusuran yang dapat digunakan pelanggan untuk memberikan ulasan lokasi.

can_have_business_calls

bool

Hanya output. Menunjukkan apakah listingan memenuhi syarat untuk panggilan bisnis.

has_voice_of_merchant

bool

Hanya output. Menunjukkan apakah listingan memiliki Voice of Merchant. Jika boolean ini salah, Anda harus memanggil locations.getVoiceOfMerchantState API untuk mendapatkan detail mengapa API tersebut tidak memiliki Voice of Merchant.

MoreHours

Jangka waktu saat lokasi buka untuk jenis bisnis tertentu.

Kolom
hours_type_id

string

Wajib. Jenis jam buka. Klien harus memanggil {#link businessCategory:BatchGet} untuk mendapatkan jenis jam yang didukung untuk kategori lokasi mereka.

periods[]

TimePeriod

Wajib. Kumpulan waktu saat lokasi ini buka. Setiap periode mewakili rentang jam saat lokasi buka selama seminggu.

MoreHoursType

Jenis jam buka lainnya yang dapat ditawarkan bisnis, selain jam regulernya.

Kolom
hours_type_id

string

Hanya output. ID stabil yang diberikan oleh Google untuk jenis jam ini.

display_name

string

Hanya output. Nama tampilan bahasa Inggris yang dapat dibaca manusia untuk jenis jam.

localized_display_name

string

Hanya output. Nama tampilan yang dilokalkan dan dapat dibaca manusia untuk jenis jam.

OpenInfo

Informasi yang terkait dengan status buka bisnis.

Kolom
status

OpenForBusiness

Wajib. Menunjukkan apakah Lokasi saat ini buka atau tidak. Semua lokasi buka secara default, kecuali jika diperbarui ke tutup.

can_reopen

bool

Hanya output. Menunjukkan apakah bisnis ini memenuhi syarat untuk dibuka kembali.

opening_date

Date

Opsional. Tanggal saat lokasi pertama kali dibuka. Jika hari persisnya tidak diketahui, hanya bulan dan tahun yang dapat diberikan. Tanggal harus berada di masa lalu atau tidak lebih dari satu tahun ke depan.

OpenForBusiness

Menunjukkan status lokasi.

Enum
OPEN_FOR_BUSINESS_UNSPECIFIED Tidak ditentukan.
OPEN Menunjukkan bahwa lokasi buka.
CLOSED_PERMANENTLY Menunjukkan bahwa lokasi telah tutup permanen.
CLOSED_TEMPORARILY Menunjukkan bahwa lokasi telah tutup sementara.

PhoneNumbers

Kumpulan nomor telepon untuk bisnis. Selama update, kedua kolom harus ditetapkan. Klien tidak boleh memperbarui hanya nomor telepon utama atau tambahan menggunakan mask pembaruan. Format telepon internasional lebih disarankan, seperti "+1 415 555 0132", lihat selengkapnya di (https://developers.google.com/style/phone-numbers#international-phone-numbers).

Kolom
primary_phone

string

Wajib. Nomor telepon yang dapat langsung terhubung ke lokasi bisnis individual Anda. Gunakan nomor telepon lokal, bukan nomor bantuan pusat layanan sentral, jika memungkinkan.

additional_phones[]

string

Opsional. Maksimal dua nomor telepon (ponsel atau telepon rumah, bukan faks) yang dapat digunakan untuk menghubungi bisnis Anda, selain nomor telepon utama.

PlaceInfo

Menentukan area yang direpresentasikan oleh ID tempat.

Kolom
place_name

string

Wajib. Nama tempat yang dilokalkan. Misalnya, Scottsdale, AZ.

place_id

string

Wajib. ID tempat. Harus sesuai dengan wilayah. (https://developers.google.com/places/web-service/supported_types#table3)

Tempat

Mendefinisikan gabungan area yang direpresentasikan oleh sekumpulan tempat.

Kolom
place_infos[]

PlaceInfo

Area yang direpresentasikan oleh ID tempat. Dibatasi maksimum 20 tempat.

Profil

Semua informasi yang berkaitan dengan profil lokasi.

Kolom
description

string

Wajib. Deskripsi lokasi dengan suara Anda sendiri, tidak dapat diedit oleh orang lain.

RelationshipData

Informasi semua lokasi induk dan turunan yang terkait dengan lokasi ini.

Kolom
parent_location

RelevantLocation

Lokasi induk yang terkait dengan lokasi ini.

children_locations[]

RelevantLocation

Daftar lokasi turunan yang memiliki hubungan dengan lokasi ini.

parent_chain

string

Nama resource Jaringan tempat lokasi ini menjadi anggota. [Cara menemukan ID Jaringan Bisnis] [Locations.SearchChains]

RelevantLocation

Informasi tentang lokasi lain yang terkait dengan lokasi saat ini. Relasinya dapat berupa salah satu dari DEPARTMENT_OF atau INDEPENDENT_ESTABLISHMENT_OF, dan lokasi yang ditentukan di sini dapat berada di salah satu sisi (induk/turunan) lokasi.

Kolom
place_id

string

Wajib. Menentukan lokasi yang ada di sisi lain hubungan menurut placeID-nya.

relation_type

RelationType

Wajib. Jenis hubungan.

RelationType

Relasi jenis yang akan ditentukan.

Enum
RELATION_TYPE_UNSPECIFIED Jenis tidak ditentukan.
DEPARTMENT_OF Hal ini merepresentasikan hubungan antara 2 lokasi yang memiliki satu area fisik yang sama, merek/manajemen tingkat atas/organisasi yang sama, tetapi dengan atribut utama yang berbeda seperti jam buka toko atau nomor telepon. Misalnya, Apotek Hypermart adalah departemen di Pusat Grosir Alfamart.
INDEPENDENT_ESTABLISHMENT_IN Ini mewakili kasus saat 2 lokasi berada dalam lokasi fisik yang sama, tetapi dari perusahaan yang berbeda (mis. Starbucks di Safeway, toko di suatu mal).

RepeatedEnumAttributeValue

Nilai untuk atribut dengan value_type REPEATED_ENUM. ID nilai ini terdiri dari dua daftar ID nilai: ID yang ditetapkan (benar) dan ID yang tidak ditetapkan (salah). Nilai yang tidak ada dianggap tidak diketahui. Minimal satu nilai harus ditentukan.

Kolom
set_values[]

string

Nilai enum yang ditetapkan.

unset_values[]

string

Nilai enum yang tidak ditetapkan.

SearchChainsRequest

Pesan permintaan untuk locations.SearchChains.

Kolom
chain_name

string

Wajib. Telusuri jaringan bisnis berdasarkan namanya. Kueri terkait yang tepat/sebagian/tidak jelas/terkait didukung. Contoh: "walmart", "wal-mart", "walmmmart", "沃尔玛"

page_size

int32

Jumlah maksimum jaringan yang cocok yang akan ditampilkan dari kueri ini. Defaultnya adalah 10. Nilai maksimum yang memungkinkan adalah 500.

SearchChainsResponse

Pesan respons untuk locations.SearchChains.

Kolom
chains[]

Chain

Jaringan yang cocok dengan chain_display_name yang dikueri di SearchChainsRequest. Jika tidak ada kecocokan, kolom ini akan kosong. Hasil dicantumkan dalam urutan relevansi.

SearchGoogleLocationsRequest

Pesan permintaan untuk GoogleLocations.SearchGoogleLocations.

Kolom
page_size

int32

Jumlah kecocokan yang akan ditampilkan. Nilai defaultnya adalah 3, dengan maksimum 10. Perlu diketahui bahwa latensi dapat meningkat jika permintaan yang diajukan lebih banyak. Tidak ada penomoran halaman.

Kolom union search_query. Kueri penelusuran. Ini dapat diberikan sebagai objek lokasi atau kueri string. search_query hanya ada berupa salah satu diantara berikut:
location

Location

Lokasi yang akan ditelusuri. Jika disediakan, akan menemukan lokasi yang cocok dengan detail lokasi yang diberikan.

query

string

Kueri teks untuk ditelusuri. Hasil penelusuran dari string kueri akan kurang akurat dibandingkan jika memberikan lokasi yang tepat, tetapi dapat memberikan lebih banyak kecocokan yang tidak tepat.

SearchGoogleLocationsResponse

Pesan respons untuk GoogleLocations.SearchGoogleLocations.

Kolom
google_locations[]

GoogleLocation

Kumpulan GoogleLocations yang berpotensi cocok dengan permintaan yang ditentukan, yang dicantumkan dalam urutan dari yang paling akurat hingga yang paling tidak akurat.

ServiceAreaBusiness

Bisnis jasa sistem panggilan menyediakan layanan mereka di lokasi pelanggan (misalnya, tukang kunci atau tukang leding).

Kolom
business_type

BusinessType

Wajib. Menunjukkan [type] [google.mybusiness.businessinfo.v1.ServiceAreaBusiness.BusinessType] dari bisnis jasa sistem panggilan.

places

Places

Area yang dilayani bisnis ini yang ditentukan melalui sekumpulan tempat.

region_code

string

Tidak dapat diubah. Kode wilayah CLDR negara/wilayah tempat bisnis jasa sistem panggilan ini berada. Lihat http://cldr.unicode.org/ dan http://www.unicode.org/cldr/charts/30/supplemental/territory_information.html untuk mengetahui detailnya. Contoh: "CH" untuk Swiss.

Kolom ini wajib diisi untuk bisnis CUSTOMER_LOCATION_ONLY, dan akan diabaikan jika tidak.

Wilayah yang ditetapkan di sini bisa berbeda dari wilayah untuk area yang dilayani bisnis ini (mis., bisnis jasa sistem panggilan yang menyediakan layanan di wilayah selain tempat mereka berada).

Jika lokasi ini memerlukan verifikasi setelah dibuat, alamat yang diberikan untuk tujuan verifikasi harus berada di wilayah ini, dan pemilik bisnis atau perwakilan resminya harus dapat menerima surat pos di alamat verifikasi yang diberikan.

BusinessType

Menunjukkan apakah bisnis ini hanya menawarkan layanan di lokasi pelanggan (misalnya, truk derek), atau di alamat dan di lokasi (misalnya, toko pizza dengan ruang makan, yang juga melakukan pengiriman ke pelanggan).

Enum
BUSINESS_TYPE_UNSPECIFIED Hanya output. Tidak ditentukan.
CUSTOMER_LOCATION_ONLY Hanya menawarkan layanan di area sekitar (bukan di alamat bisnis). Jika bisnis diperbarui dari CUSTOMER_AND_BUSINESS_LOCATION ke CUSTOMER_LOCATION_ONLY, pembaruan lokasi harus menyertakan mask kolom storefront_address dan menetapkan kolom ke kosong.
CUSTOMER_AND_BUSINESS_LOCATION Menawarkan layanan di alamat bisnis dan area sekitar.

ServiceItem

Pesan yang menjelaskan satu item layanan. Atribut ini digunakan untuk mendeskripsikan jenis layanan yang disediakan penjual. Misalnya, layanan potong rambut.

Kolom
price

Money

Opsional. Mewakili harga uang dari item layanan. Sebaiknya currency_code dan unit harus ditetapkan saat menyertakan harga. Ini akan diperlakukan sebagai harga tetap untuk item layanan.

Kolom union service_item_info. Salah satu kolom berikut harus selalu ditetapkan. service_item_info hanya ada berupa salah satu diantara berikut:
structured_service_item

StructuredServiceItem

Opsional. Kolom ini akan ditetapkan sebagai kasus data layanan terstruktur.

free_form_service_item

FreeFormServiceItem

Opsional. Kolom ini akan ditetapkan sebagai kasus untuk data layanan bentuk bebas.

FreeFormServiceItem

Mewakili layanan bentuk bebas yang ditawarkan oleh penjual. Ini adalah layanan yang tidak diekspos sebagai bagian dari data layanan struktur kami. Penjual secara manual memasukkan nama untuk layanan tersebut melalui platform geolokasi.

Kolom
category

string

Wajib. Kolom ini menunjukkan nama kategori (yaitu ID stabil kategori). category dan service_type_id harus cocok dengan kemungkinan kombinasi yang diberikan di pesan Category.

label

Label

Wajib. Label dengan tag bahasa untuk item. Sebaiknya nama item terdiri dari 140 karakter atau kurang dan deskripsi 250 karakter atau kurang. Kolom ini hanya boleh ditetapkan jika inputnya adalah item layanan kustom. Jenis layanan standar harus diperbarui melalui service_type_id.

StructuredServiceItem

Mewakili layanan terstruktur yang ditawarkan oleh penjual. Misalnya: toilet_installation.

Kolom
service_type_id

string

Wajib. Kolom service_type_id adalah ID unik yang diberikan Google yang dapat ditemukan di ServiceType. Informasi ini disediakan oleh layanan rpc BatchGetCategories.

description

string

Opsional. Deskripsi item layanan terstruktur. Batas karakternya adalah 300.

ServiceType

Pesan yang menjelaskan jenis layanan yang ditawarkan bisnis.

Kolom
service_type_id

string

Hanya output. ID stabil (disediakan oleh Google) untuk jenis layanan ini.

display_name

string

Hanya output. Nama tampilan yang dapat dibaca manusia untuk jenis layanan.

SpecialHourPeriod

Merepresentasikan jangka waktu tunggal jika jam operasional lokasi berbeda dari jam buka normalnya. Periode jam khusus harus mewakili rentang yang kurang dari 24 jam. open_time dan start_date harus terjadi sebelum close_time dan end_date. close_time dan end_date dapat diperluas hingga pukul 11.59 pada hari setelah start_date yang ditentukan. Misalnya, input berikut valid:

start_date=2015-11-23, open_time=08:00, close_time=18:00
start_date=2015-11-23, end_date=2015-11-23, open_time=08:00,
close_time=18:00 start_date=2015-11-23, end_date=2015-11-24,
open_time=13:00, close_time=11:59

Input berikut tidak valid:

start_date=2015-11-23, open_time=13:00, close_time=11:59
start_date=2015-11-23, end_date=2015-11-24, open_time=13:00,
close_time=12:00 start_date=2015-11-23, end_date=2015-11-25,
open_time=08:00, close_time=18:00
Kolom
start_date

Date

Wajib. Tanggal kalender saat periode jam khusus ini dimulai.

open_time

TimeOfDay

Opsional. Nilai yang valid adalah 00:00-24:00 dengan 24:00 merepresentasikan tengah malam di akhir kolom hari yang ditentukan. Harus ditentukan jika closed salah.

end_date

Date

Opsional. Tanggal kalender saat periode jam khusus ini berakhir. Jika kolom end_date tidak ditetapkan, setelan default adalah tanggal yang ditentukan di start_date. Jika ditetapkan, kolom ini harus sama dengan atau maksimum 1 hari setelah start_date.

close_time

TimeOfDay

Opsional. Nilai yang valid adalah 00:00-24:00, dengan 24:00 merepresentasikan tengah malam di akhir kolom hari yang ditentukan. Harus ditentukan jika closed salah.

closed

bool

Opsional. Jika benar, end_date, open_time, dan close_time diabaikan, dan tanggal yang ditentukan di start_date dianggap sebagai lokasi yang tutup sepanjang hari.

SpecialHours

Merepresentasikan kumpulan jangka waktu saat jam operasional lokasi berbeda dari jam buka normalnya.

Kolom
special_hour_periods[]

SpecialHourPeriod

Wajib. Daftar pengecualian untuk jam reguler bisnis.

TimePeriod

Merepresentasikan rentang waktu bisnis buka, mulai dari hari/waktu buka yang ditentukan dan tutup pada hari/waktu tutup yang ditentukan. Waktu tutup harus terjadi setelah jam buka, misalnya nanti di hari yang sama, atau pada hari berikutnya.

Kolom
open_day

DayOfWeek

Wajib. Menunjukkan day of the week periode ini dimulai.

open_time

TimeOfDay

Wajib. Nilai yang valid adalah 00:00-24:00, dengan 24:00 merepresentasikan tengah malam di akhir kolom hari yang ditentukan.

close_day

DayOfWeek

Wajib. Menunjukkan day of the week periode ini berakhir.

close_time

TimeOfDay

Wajib. Nilai yang valid adalah 00:00-24:00, dengan 24:00 merepresentasikan tengah malam di akhir kolom hari yang ditentukan.

UpdateAttributesRequest

Permintaan untuk AttributesService.UpdateAttributes.

Kolom
attributes

Attributes

Kumpulan atribut yang perlu diperbarui.

attribute_mask

FieldMask

Wajib. Nama atribut atribut yang ingin Anda perbarui. Direpresentasikan oleh attributes/{attribute}.

Pembaruan: Semua atribut yang diberikan di kolom atribut yang ingin Anda perbarui harus ditetapkan di attribute_mask. Atribut yang ditetapkan dalam daftar di atas tetapi tidak dalam attribute_mask akan diabaikan.

Menghapus: Jika Anda ingin menghapus atribut tertentu, atribut tersebut harus ditentukan di attribute_mask tanpa entri yang cocok di daftar atribut. Jika ingin menghapus semua atribut yang ditetapkan pada lokasi, Anda harus mencari semua atribut yang berlaku untuk lokasi tersebut, lalu menambahkannya ke attribute_mask dengan kolom atribut kosong.

UpdateLocationRequest

Pesan permintaan untuk Locations.UpdateLocation.

Kolom
location

Location

Wajib. Informasi lokasi yang diperbarui.

update_mask

FieldMask

Wajib. Kolom spesifik yang akan diperbarui.

validate_only

bool

Opsional. Jika benar, permintaan divalidasi tanpa benar-benar memperbarui lokasi. Jika kolom ini ditetapkan, kami hanya akan menampilkan error validasi jika ada. Respons akan kosong jika tidak ditemukan error.

UriAttributeValue

Nilai untuk atribut dengan value_type URL.

Kolom
uri

string

Wajib. Nilai URI yang diusulkan untuk atribut ini.