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,
  "scheduledTime": string,
  "recurringInstanceTime": string,
  "event": {
    object (LocalPostEvent)
  },
  "state": enum (LocalPostState),
  "media": [
    {
      object (MediaItem)
    }
  ],
  "searchUrl": string,
  "topicType": enum (LocalPostTopicType),
  "alertType": enum (AlertType),

  // Union field topic_type_specific_fields can be only one of the following:
  "offer": {
    object (LocalPostOffer)
  }
  // End of list of possible types for union field topic_type_specific_fields.
}
Kolom
name

string

Hanya output. ID Google untuk postingan lokal ini dalam bentuk: accounts/{accountId}/locations/{locationId}/localPosts/{local_post_id}
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.

Menggunakan RFC 3339 yang outputnya akan selalu dinormalisasi Z dan menggunakan 0, 3, 6, atau 9 digit pecahan. Offset selain "Z" juga diterima. Contoh: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z", atau "2014-10-02T15:01:23+05:30".
updateTime

string (Timestamp format)

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

Menggunakan RFC 3339 yang outputnya akan selalu dinormalisasi Z dan menggunakan 0, 3, 6, atau 9 digit pecahan. Offset selain "Z" juga diterima. Contoh: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z", atau "2014-10-02T15:01:23+05:30".
scheduledTime

string (Timestamp format)

Jika disetel, menentukan kapan postingan akan dipublikasikan. Hal ini dapat ditetapkan oleh pengguna untuk menjadwalkan postingan terlebih dahulu.

Menggunakan RFC 3339 yang outputnya akan selalu dinormalisasi Z dan menggunakan 0, 3, 6, atau 9 digit pecahan. Offset selain "Z" juga diterima. Contoh: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z", atau "2014-10-02T15:01:23+05:30".
recurringInstanceTime
(deprecated)

string (Timestamp format)

Hanya output. Tidak digunakan lagi: Gunakan event.recurring_instance_time sebagai gantinya. Kolom ini akan dihapus pada versi mendatang. Hanya output. Waktu saat instance berulang terbaru dari postingan diperbarui.

Menggunakan RFC 3339 yang outputnya akan selalu dinormalisasi Z dan menggunakan 0, 3, 6, atau 9 digit pecahan. Offset selain "Z" juga diterima. Contoh: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z", atau "2014-10-02T15:01:23+05:30".
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, teks, dll.
topicType

enum (LocalPostTopicType)

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

enum (AlertType)

Jenis notifikasi untuk postingan yang dibuat. Kolom ini hanya berlaku untuk postingan topicType Alert, dan berfungsi sebagai sub-jenis Notifikasi.
Kolom union topic_type_specific_fields. Kolom tertentu untuk jenis topik. topic_type_specific_fields hanya dapat berupa salah satu dari berikut:
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)
  },
  "recurrenceInfo": {
    object (RecurrenceInfo)
  },
  "recurringInstanceTime": string
}
Kolom
title

string

nama acara.
schedule

object (TimeInterval)

Tanggal/waktu mulai dan berakhir acara.
recurrenceInfo

object (RecurrenceInfo)

Opsional. Menyimpan info tentang irama postingan berulang. Hanya akan disetel jika postingan adalah postingan berulang.
recurringInstanceTime

string (Timestamp format)

Hanya output. Waktu saat instance berulang terbaru dari postingan diperbarui.

Menggunakan RFC 3339 yang outputnya akan selalu dinormalisasi Z dan menggunakan 0, 3, 6, atau 9 digit pecahan. Offset selain "Z" juga diterima. Contoh: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z", atau "2014-10-02T15:01:23+05:30".

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 berakhir periode ini.
endTime

object (TimeOfDay)

Waktu berakhir periode ini.

Tanggal

Menunjukkan seluruh atau sebagian tanggal kalender, seperti ulang tahun. Waktu dan zona waktu ditentukan di tempat lain atau dianggap tidak signifikan. Tanggal ini terkait dengan Kalender Gregorian. Hal ini dapat mewakili salah satu dari berikut ini:

  • Tanggal lengkap, dengan nilai tahun, bulan, dan hari bukan nol.
  • Bulan dan hari, dengan tahun nol (misalnya, hari jadi).
  • Tahun saja, dengan bulan nol dan hari nol.
  • Tahun dan bulan, dengan hari nol (misalnya, tanggal habis masa berlaku kartu kredit).

Jenis terkait:

Representasi JSON 
{
  "year": integer,
  "month": integer,
  "day": integer
}
Kolom
year

integer

Tahun dalam tanggal. Harus dari 1 hingga 9999, atau 0 untuk menentukan tanggal tanpa tahun.
month

integer

Bulan dalam setahun. Harus dari 1 hingga 12, atau 0 untuk menentukan tahun tanpa bulan dan hari.
day

integer

Hari dalam sebulan. Harus dari 1 hingga 31 dan berlaku untuk tahun dan bulan, atau 0 untuk menentukan tahun saja atau tahun dan bulan jika hari dianggap tidak signifikan.

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 lebih besar dari atau sama dengan 0 dan biasanya harus kurang dari atau sama dengan 23. API dapat memilih untuk mengizinkan nilai "24:00:00" untuk skenario seperti waktu tutup bisnis.
minutes

integer

Menit dalam satu jam. Harus lebih besar dari atau sama dengan 0 dan kurang dari atau sama dengan 59.
seconds

integer

Detik dalam satu menit. Harus lebih besar dari atau sama dengan 0 dan biasanya harus kurang dari atau sama dengan 59. API dapat mengizinkan nilai 60 jika memungkinkan lompatan-detik.
nanos

integer

Pecahan detik, dalam nanodetik. Harus lebih besar dari atau sama dengan 0 dan kurang dari atau sama dengan 999.999.999.

RecurrenceInfo

Merepresentasikan informasi pengulangan untuk postingan lokal.

Representasi JSON 
{
  "seriesEndTime": string,

  // Union field occurrence_pattern can be only one of the following:
  "dailyPattern": {
    object (DailyOccurrencePattern)
  },
  "weeklyPattern": {
    object (WeeklyOccurrencePattern)
  },
  "monthlyPattern": {
    object (MonthlyOccurrencePattern)
  }
  // End of list of possible types for union field occurrence_pattern.
}
Kolom
seriesEndTime

string (Timestamp format)

Opsional. Waktu berakhir rangkaian pengulangan.

Menggunakan RFC 3339 yang outputnya akan selalu dinormalisasi Z dan menggunakan 0, 3, 6, atau 9 digit pecahan. Offset selain "Z" juga diterima. Contoh: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z", atau "2014-10-02T15:01:23+05:30".
Kolom union occurrence_pattern. Pola kemunculan untuk postingan berulang. occurrence_pattern hanya dapat berupa salah satu dari berikut:
dailyPattern

object (DailyOccurrencePattern)

Pola kemunculan harian.
weeklyPattern

object (WeeklyOccurrencePattern)

Pola kemunculan mingguan.
monthlyPattern

object (MonthlyOccurrencePattern)

Pola kemunculan bulanan.

DailyOccurrencePattern

Jenis ini tidak memiliki kolom.

Mewakili pola kemunculan harian.

WeeklyOccurrencePattern

Mewakili pola kemunculan mingguan.

Representasi JSON 
{
  "daysOfWeek": [
    enum (DayOfWeek)
  ]
}
Kolom
daysOfWeek[]

enum (DayOfWeek)

Opsional. Daftar hari dalam seminggu untuk penawaran/acara. Jika kosong, postingan akan diulang pada hari yang sama dalam seminggu dengan schedule.start_time acara.

DayOfWeek

Mewakili hari dalam seminggu.

Enum
DAY_OF_WEEK_UNSPECIFIED Hari dalam seminggu tidak ditentukan.
MONDAY Senin
TUESDAY Selasa
WEDNESDAY Rabu
THURSDAY Kamis
FRIDAY Jumat
SATURDAY Sabtu
SUNDAY Minggu

MonthlyOccurrencePattern

Mewakili pola kemunculan bulanan.

Representasi JSON 
{

  // Union field monthly_option can be only one of the following:
  "dayOfMonth": integer,
  "dayOfWeekOccurrence": enum (DayOfWeekOccurrence)
  // End of list of possible types for union field monthly_option.
}
Kolom
Kolom union monthly_option. Opsi pengulangan untuk pola kemunculan bulanan. monthly_option hanya dapat berupa salah satu dari berikut:
dayOfMonth

integer

Hari dalam bulan.
dayOfWeekOccurrence

enum (DayOfWeekOccurrence)

Kemunculan hari dalam seminggu dalam sebulan. Hari dalam seminggu tersirat dari hari dalam seminggu pada waktu mulai acara. Misalnya, jika acara dimulai pada hari Jumat dan dayOfWeekOccurrence adalah SECOND, acara akan berulang pada hari Jumat kedua setiap bulan.

DayOfWeekOccurrence

Kemunculan hari dalam seminggu dalam sebulan.

Enum
DAY_OF_WEEK_OCCURRENCE_UNSPECIFIED Kemunculan hari dalam seminggu yang tidak ditentukan.
FIRST Hari pertama dalam seminggu dalam sebulan.
SECOND Hari kedua dalam seminggu dalam sebulan.
THIRD Hari ketiga dalam seminggu pada bulan.
FOURTH Hari keempat dalam seminggu pada bulan tersebut.
LAST Hari terakhir dalam seminggu pada bulan tersebut.

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.
SCHEDULED Postingan ini dijadwalkan untuk masa mendatang dan tidak muncul dalam hasil penelusuran.
RECURRING Postingan ini adalah postingan berulang dan saat ini 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 acara.
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 peringatan yang ditentukan.
COVID_19 Peringatan yang terkait dengan pandemi Penyakit Virus Corona 2019. Postingan Covid hanya mendukung kolom ringkasan dan kolom pesan ajakan. Jika peringatan 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 menukar 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.