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 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 pada postingan yang dibuat oleh pengguna.

Stempel waktu dalam 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, yang 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, pesan teks, dll.

topicType

enum (LocalPostTopicType)

Wajib. Jenis topik postingan: standar, acara, penawaran, atau notifikasi.

alertType

enum (AlertType)

Jenis notifikasi untuk postingan yang dibuat. Kolom ini hanya berlaku untuk postingan Notifikasi topicType, dan berfungsi 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 dituju pengguna setelah mengklik. Kolom ini harus dibiarkan tidak disetel untuk CTA Panggilan.

ActionType

Jenis tindakan yang akan dilakukan.

Enum
ACTION_TYPE_UNSPECIFIED Jenis belum ditetapkan.
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 situsnya).
SIGN_UP Postingan ini menginginkan pengguna mendaftar/mendaftar/bergabung ke 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. Parameter 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 memungkinkan 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 waktu tutup bisnis.

minutes

integer

Menit dalam jam. Harus dari 0 hingga 59.

seconds

integer

Detik dalam waktu. Biasanya harus dari 0 hingga 59. API dapat mengizinkan nilai 60 jika memungkinkan lompatan-detik.

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 ditampilkan 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 guna 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 acara.
OFFER Postingan berisi informasi dasar, acara, dan konten terkait penawaran (misalnya, kode kupon)
ALERT Pengumuman berprioritas tinggi dan tepat waktu yang terkait dengan acara yang sedang berlangsung. Jenis postingan ini tidak selalu tersedia untuk pembuatan.

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 masih dapat mengelola postingan COVID-19 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 yang ditentukan, 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 tertentu dan menampilkan postingan lokal yang diperbarui.

reportInsights

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