Membuat Postingan di Google

Google My Business API memberi Anda kemampuan untuk membuat Postingan di Google Penelusuran dalam beberapa kategori, seperti berita, acara, dan penawaran.

Tutorial ini menunjukkan kepada Anda cara melakukan hal berikut:

Sebelum memulai

Sebelum menggunakan Google My Business API, Anda harus mendaftarkan aplikasi Anda dan mendapatkan kredensial OAuth 2.0.

Untuk mengetahui detail cara mulai menggunakan Google My Business API, lihat Penyiapan dasar.

Postingan Acara

Beri tahu pelanggan Anda tentang acara berikutnya di bisnis Anda dengan Postingan. Postingan Anda untuk acara mencakup tanggal mulai dan akhir, yang ditampilkan secara jelas di Postingan.

Untuk membuat Postingan ke akun yang dikaitkan dengan pengguna, gunakan accounts.locations.localPosts API.

Untuk membuat Postingan bagi pengguna terautentikasi, gunakan hal berikut:

HTTP
$ 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) mencakup tombol. Teks pada tombol pesan ajakan (CTA) ditentukan oleh kolom actionType di Postingan. Link ke URL yang diberikan pengguna ditambahkan ke tombol.

Untuk membuat Postingan dengan tombol pesan ajakan (CTA), gunakan hal berikut:

HTTP
$ 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 Postingan pesan ajakan (CTA).

Berikut adalah jenis pesan ajakan (CTA) yang didukung:

Jenis tindakan
BOOK Membuat Postingan yang meminta pengguna memesan slot janji temu, meja, atau sesuatu hal lain yang serupa.
ORDER Membuat Postingan yang meminta pengguna memesan sesuatu.
SHOP Membuat Postingan yang meminta pengguna menjelajahi katalog produk.
LEARN_MORE Membuat Postingan yang meminta pengguna melihat detail tambahan di situs.
SIGN_UP Membuat Postingan yang meminta pengguna untuk meregistrasi, mendaftar, atau bergabung dengan sesuatu.
CALL Membuat Postingan yang meminta pengguna untuk menelepon bisnis.

Postingan Penawaran

Untuk membuat Postingan Penawaran, gunakan hal berikut:

HTTP
$ 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"
}

Mengedit Postingan

Setelah postingan dibuat, Anda dapat mengeditnya dengan permintaan PATCH.

Untuk mengedit Postingan, gunakan hal berikut:

HTTP
$ 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:

HTTP
$ DELETE
https://mybusiness.googleapis.com/v4/accounts/{accountId}/locations/{locationId}/localPosts/{localPostId}