Membuat Postingan di Google

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:

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:

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) 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:

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

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

Edit 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}