Google My Business API memberi Anda kemampuan untuk membuat Postingan di Google Penelusuran termasuk dalam beberapa kategori, seperti berita, acara, dan penawaran.
Tutorial ini menunjukkan cara melakukan hal berikut:
- Membuat Postingan Acara.
- Membuat Postingan Pesan Ajakan (CTA).
- Membuat Postingan Penawaran.
- Mengedit Postingan.
- Menghapus Postingan.
Sebelum memulai
Sebelum menggunakan Google My Business API, Anda harus mendaftarkan permohonan dan mendapatkan kredensial OAuth 2.0.
Untuk mendapatkan detail tentang cara memulai Google My Business API, lihat Dasar-dasar penyiapan.
Postingan Acara
Beri tahu pelanggan tentang acara berikutnya di bisnis Anda melalui Postingan. Nama Postingan untuk acara mencakup tanggal dan waktu mulai dan akhir, yang ditampilkan secara jelas di Postingan.
Untuk membuat Postingan ke akun yang terkait dengan pengguna, gunakan
API accounts.locations.localPosts
.
Untuk membuat Postingan bagi pengguna terautentikasi, gunakan hal berikut:
$ POST https://mybusiness.googleapis.com/v4/accounts/{accountId}/locations/{locationId}/localPosts { "languageCode": "en-US", "summary": "Come in for our spooky Halloween event!", "event": { "title": "Halloween Spook-tacular!", "schedule": { "startDate": { "year": 2017, "month": 10, "day": 31, }, "startTime": { "hours": 9, "minutes": 0, "seconds": 0, "nanos": 0, }, "endDate": { "year": 2017, "month": 10, "day": 31, }, "endTime": { "hours": 17, "minutes": 0, "seconds": 0, "nanos": 0, }, } }, "media": [ { "mediaFormat": "PHOTO", "sourceUrl": "https://www.google.com/real-image.jpg", } ], "topicType": "EVENT" }
Postingan Pesan Ajakan (CTA)
Postingan dengan pesan ajakan (CTA) menyertakan tombol. Teks pada pesan ajakan (CTA)
tombol ditentukan oleh kolom actionType
di Postingan. Tautan ke
URL yang disediakan pengguna ditambahkan ke tombol.
Untuk membuat Postingan dengan tombol pesan ajakan (CTA), gunakan hal berikut:
$ POST https://mybusiness.googleapis.com/v4/accounts/{accountId}/locations/{locationId}/localPosts { "languageCode": "en-US", "summary": "Order your Thanksgiving turkeys now!!", "callToAction": { "actionType": "ORDER", "url": "http://google.com/order_turkeys_here", }, "media": [ { "mediaFormat": "PHOTO", "sourceUrl": "https://www.google.com/real-turkey-photo.jpg", } ], "topicType": "OFFER" }
Jenis tindakan
Postingan pesan ajakan (CTA) dapat memiliki berbagai jenis tindakan yang menentukan jenis di postingan pesan ajakan (CTA).
Berikut adalah jenis pesan ajakan (CTA) yang didukung:
Jenis tindakan | |
---|---|
BOOK |
Membuat Postingan yang meminta pengguna memesan janji temu, tabel, atau sesuatu yang mirip. |
ORDER |
Membuat Postingan yang meminta pengguna memesan sesuatu. |
SHOP |
Membuat Postingan yang meminta pengguna menjelajahi produk katalog. |
LEARN_MORE |
Membuat Postingan yang meminta pengguna melihat detail tambahan pada situs Anda. |
SIGN_UP |
Membuat Postingan yang meminta pengguna untuk mendaftar, mendaftar, atau bergabung sesuatu. |
CALL |
Membuat Postingan yang meminta pengguna untuk menelepon bisnis. |
Postingan Penawaran
Untuk membuat Postingan Penawaran, gunakan hal berikut:
$ POST https://mybusiness.googleapis.com/v4/accounts/{accountId}/locations/{locationId}/localPosts { "languageCode": "en-US", "summary": "Buy one Google jetpack, get a second one free!!", "offer": { "couponCode": “BOGO-JET-CODE”, "redeemOnlineUrl": “https://www.google.com/redeem”, "termsConditions": “Offer only valid if you can prove you are a time traveler” }, "media": [ { "mediaFormat": "PHOTO", "sourceUrl": "https://www.google.com/real-jetpack-photo.jpg", } ], "topicType": "OFFER" }
Edit Postingan
Setelah postingan dibuat, Anda dapat mengeditnya dengan permintaan PATCH
.
Untuk mengedit Postingan, gunakan hal berikut:
$ PATCH https://mybusiness.googleapis.com/v4/accounts/{accountId}/locations/{locationId}/localPosts/{localPostId}?updateMask=summary { "summary": "Order your Christmas turkeys now!!" }
Menghapus Postingan
Setelah Postingan dibuat, Anda dapat menghapusnya dengan permintaan DELETE
.
Untuk menghapus Postingan, gunakan hal berikut:
$ DELETE https://mybusiness.googleapis.com/v4/accounts/{accountId}/locations/{locationId}/localPosts/{localPostId}