REST Resource: accounts.locations.localPosts

Resource: LocalPost

Merepresentasikan postingan lokal untuk lokasi.

Representasi JSON 
{
  "name": string,
  "languageCode": string,
  "summary": string,
  "callToAction": {
    object (CallToAction)
  },
  "createTime": string,
  "updateTime": string,
  "event": {
    object (LocalPostEvent)
  },
  "state": enum (LocalPostState),
  "media": [
    {
      object (MediaItem)
    }
  ],
  "searchUrl": string,
  "topicType": enum (LocalPostTopicType),
  "alertType": enum (AlertType),
  "offer": {
    object (LocalPostOffer)
  }
}
Kolom
name

string

Hanya output. ID Google untuk postingan lokal ini dalam bentuk: accounts/{accountId}/locations/{locationId}/localPosts/{localPostId}
languageCode

string

Bahasa postingan lokal.
summary

string

Deskripsi/isi postingan lokal.
callToAction

object (CallToAction)

URL tempat pengguna akan dikirim saat mengklik promosi. Diabaikan untuk jenis topik OFFER.
createTime

string (Timestamp format)

Hanya output. Waktu pembuatan postingan.

Stempel waktu dalam format RFC3339 UTC "Zulu", dengan resolusi nanodetik dan hingga sembilan digit pecahan. Contoh: "2014-10-02T15:01:23Z" dan "2014-10-02T15:01:23.045123456Z".
updateTime

string (Timestamp format)

Hanya output. Waktu modifikasi terakhir postingan yang dibuat oleh pengguna.

Stempel waktu dalam format RFC3339 UTC "Zulu", dengan resolusi nanodetik dan hingga sembilan digit pecahan. Contoh: "2014-10-02T15:01:23Z" dan "2014-10-02T15:01:23.045123456Z".
event

object (LocalPostEvent)

Informasi peristiwa. Diperlukan untuk jenis topik EVENT dan OFFER.
state

enum (LocalPostState)

Hanya output. Status postingan, yang menunjukkan di bagian mana postingan tersebut berada dalam siklus hidupnya.
media[]

object (MediaItem)

Media yang terkait dengan postingan. sourceUrl adalah satu-satunya kolom data yang didukung untuk LocalPost MediaItem.
searchUrl

string

Hanya output. Link ke postingan lokal di Google Penelusuran. Link ini dapat digunakan untuk membagikan postingan melalui media sosial, email, teks, dll.
topicType

enum (LocalPostTopicType)

Wajib. Jenis topik postingan: standar, acara, penawaran, atau pemberitahuan.
alertType

enum (AlertType)

Jenis notifikasi untuk postingan yang dibuat. Kolom ini hanya berlaku untuk postingan topicType Notifikasi, dan berperilaku sebagai subjenis Notifikasi.
offer

object (LocalPostOffer)

Data tambahan untuk postingan penawaran. Kolom ini hanya boleh ditetapkan jika topicType adalah OFFER.

CallToAction

Tindakan yang dilakukan saat pengguna mengklik postingan

Representasi JSON 
{
  "actionType": enum (ActionType),
  "url": string
}
Kolom
actionType

enum (ActionType)

Jenis tindakan yang akan dilakukan.
url

string

URL yang akan digunakan untuk mengarahkan pengguna setelah mengklik. Kolom ini harus dibiarkan tidak ditetapkan untuk Call CTA.

ActionType

Jenis tindakan yang akan dilakukan.

Enum
ACTION_TYPE_UNSPECIFIED Jenis tidak ditentukan.
BOOK Postingan ini menginginkan pengguna memesan slot janji temu/meja/dll.
ORDER Postingan ini menginginkan pengguna memesan sesuatu.
SHOP Postingan ini menginginkan pengguna melihat katalog produk.
LEARN_MORE Postingan ini menginginkan pengguna mempelajari lebih lanjut (di situs mereka).
SIGN_UP Postingan ini menginginkan pengguna mendaftar/bergabung dengan sesuatu.
GET_OFFER

Tidak digunakan lagi. Gunakan OFFER di LocalPostTopicType untuk membuat postingan dengan konten penawaran.
CALL Postingan ini menginginkan pengguna menelepon bisnis.

LocalPostEvent

Semua informasi yang berkaitan dengan acara yang ditampilkan di postingan lokal.

Representasi JSON 
{
  "title": string,
  "schedule": {
    object (TimeInterval)
  }
}
Kolom
title

string

Nama peristiwa.
schedule

object (TimeInterval)

Tanggal/waktu mulai dan berakhir acara.

TimeInterval

Interval waktu, inklusif. Resource ini harus berisi semua kolom agar valid.

Representasi JSON 
{
  "startDate": {
    object (Date)
  },
  "startTime": {
    object (TimeOfDay)
  },
  "endDate": {
    object (Date)
  },
  "endTime": {
    object (TimeOfDay)
  }
}
Kolom
startDate

object (Date)

Tanggal mulai periode ini.
startTime

object (TimeOfDay)

Waktu mulai periode ini.
endDate

object (Date)

Tanggal akhir periode ini.
endTime

object (TimeOfDay)

Waktu berakhir periode ini.

TimeOfDay

Merepresentasikan waktu. Tanggal dan zona waktu tidak signifikan atau ditentukan di tempat lain. API dapat memilih untuk mengizinkan detik kabisat. Jenis terkait adalah google.type.Date dan google.protobuf.Timestamp.

Representasi JSON 
{
  "hours": integer,
  "minutes": integer,
  "seconds": integer,
  "nanos": integer
}
Kolom
hours

integer

Jam dalam format 24 jam. Harus antara 0 hingga 23. API dapat memilih untuk mengizinkan nilai "24:00:00" untuk skenario seperti waktu tutup bisnis.
minutes

integer

Menit dalam jam. Harus antara 0 hingga 59.
seconds

integer

Detik menit dari waktu. Biasanya harus berkisar antara 0 sampai 59. API dapat mengizinkan nilai 60 jika memungkinkan detik kabisat.
nanos

integer

Pecahan detik dalam nanodetik. Harus dari 0 hingga 999.999.999.

LocalPostState

Menunjukkan status postingan

Enum
LOCAL_POST_STATE_UNSPECIFIED Status tidak ditentukan.
REJECTED Postingan ini ditolak karena pelanggaran kebijakan konten.
LIVE Postingan ini dipublikasikan dan saat ini muncul dalam hasil penelusuran.
PROCESSING Postingan ini sedang diproses dan tidak muncul dalam hasil penelusuran.

LocalPostTopicType

Jenis topik postingan lokal, yang digunakan untuk memilih template yang berbeda-beda untuk membuat dan merender postingan.

Enum
LOCAL_POST_TOPIC_TYPE_UNSPECIFIED Jenis postingan tidak ditentukan.
STANDARD Postingan berisi informasi dasar, seperti ringkasan dan gambar.
EVENT Postingan berisi informasi dasar dan peristiwa.
OFFER Postingan berisi informasi dasar, acara, dan konten terkait penawaran (mis. kode kupon)
ALERT Pengumuman prioritas tinggi dan tepat waktu, yang terkait dengan peristiwa yang sedang berlangsung. Jenis postingan ini tidak selalu tersedia untuk penulisan.

AlertType

Jenis peristiwa yang postingan peringatannya telah dibuat.

Enum
ALERT_TYPE_UNSPECIFIED Tidak ada pemberitahuan yang ditetapkan.
COVID_19 Peringatan yang terkait dengan pandemi Penyakit Virus Corona 2019. Postingan terkait COVID-19 hanya mendukung kolom ringkasan dan kolom pesan ajakan (CTA). Jika notifikasi ini tidak lagi relevan, pembuatan postingan Peringatan baru untuk jenis COVID-19 akan dinonaktifkan. Namun, penjual masih dapat mengelola postingan COVID-19 yang ada.

LocalPostOffer

Kolom spesifik untuk postingan penawaran.

Representasi JSON 
{
  "couponCode": string,
  "redeemOnlineUrl": string,
  "termsConditions": string
}
Kolom
couponCode

string

Opsional. Kode penawaran yang dapat digunakan di toko atau secara online.
redeemOnlineUrl

string

Opsional. Link online untuk menukarkan penawaran.
termsConditions

string

Opsional. Persyaratan dan ketentuan penawaran.

Metode

create

 Membuat postingan lokal baru terkait lokasi yang ditentukan, lalu menampilkannya.

delete

 Menghapus postingan lokal.

get

 Mendapatkan postingan lokal yang ditentukan.

list

 Menampilkan daftar postingan lokal yang terkait dengan lokasi.

patch

 Memperbarui postingan lokal yang ditentukan dan menampilkan postingan lokal yang diperbarui.

reportInsights

 Menampilkan insight untuk kumpulan postingan lokal yang terkait dengan satu listingan.