REST Resource: accounts.locations.localPosts

Referensi: 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 diarahkan 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 acara. Diperlukan untuk jenis topik EVENT dan OFFER.
state

enum (LocalPostState)

Hanya output. Status postingan, menunjukkan di bagian mana postingan tersebut berada dalam siklus prosesnya.
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 pemberitahuan untuk postingan yang dibuat. Kolom ini hanya berlaku untuk postingan Notifikasi topicType, dan berfungsi sebagai subjenis Alerts.
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 menjadi tujuan pengguna setelah mengklik. Kolom ini harus dibiarkan tidak disetel untuk CTA Panggilan.

ActionType

Jenis tindakan yang akan dilakukan.

Enum
ACTION_TYPE_UNSPECIFIED Jenis tidak ditentukan.
BOOK Postingan ini menginginkan pengguna membuat janji temu/meja/dll.
ORDER Postingan ini menginginkan pengguna memesan sesuatu.
SHOP Postingan ini menginginkan pengguna menjelajahi 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 menghubungi 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. Kolom 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

Mewakili 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 dari 0 hingga 23. API dapat memilih untuk mengizinkan nilai "24:00:00" untuk skenario seperti jam tutup bisnis.
minutes

integer

Menit dalam jam. Harus dari 0 hingga 59.
seconds

integer

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

integer

Pecahan detik dalam nanodetik. Harus dari 0 hingga 999.999.999.

LocalPostState

Menunjukkan status postingan

Enum
LOCAL_POST_STATE_UNSPECIFIED Negara bagian tidak ditentukan.
REJECTED Postingan ini ditolak karena melanggar kebijakan konten.
LIVE Postingan ini dipublikasikan dan saat ini muncul di hasil penelusuran.
PROCESSING Postingan ini sedang diproses dan tidak muncul di hasil penelusuran.

LocalPostTopicType

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

Enum
LOCAL_POST_TOPIC_TYPE_UNSPECIFIED Tidak ada jenis postingan yang 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 berprioritas tinggi dan tepat waktu terkait acara yang sedang berlangsung. Jenis postingan ini tidak selalu tersedia untuk penulisan.

AlertType

Jenis peristiwa yang postingan pemberitahuannya dibuat.

Enum
ALERT_TYPE_UNSPECIFIED Tidak ada pemberitahuan yang ditentukan.
COVID_19 Peringatan terkait pandemi Penyakit Virus Corona 2019. Postingan Covid hanya mendukung kolom ringkasan dan kolom pesan ajakan (CTA). Jika notifikasi ini tidak lagi relevan, pembuatan Postingan notifikasi baru untuk jenis COVID-19 akan dinonaktifkan. Namun, penjual tetap dapat mengelola postingan terkait COVID-19 mereka yang sudah 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 yang terkait dengan lokasi tertentu, dan 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.