Tạo bài đăng trên Google

API Google Doanh nghiệp của tôi cho phép bạn tạo Bài đăng trong Google Tìm kiếm trong một số danh mục, chẳng hạn như tin tức, sự kiện và ưu đãi.

Hướng dẫn này sẽ chỉ cho bạn cách thực hiện những việc sau:

Trước khi bắt đầu

Trước khi sử dụng API Google Doanh nghiệp của tôi, bạn cần đăng ký ứng dụng và lấy thông tin đăng nhập OAuth 2.0.

Để biết chi tiết về cách bắt đầu sử dụng API Google Doanh nghiệp của tôi, hãy xem bài viết Cơ bản thiết lập.

Bài đăng về sự kiện

Thông báo cho khách hàng về sự kiện tiếp theo tại doanh nghiệp của bạn bằng một Bài đăng. Thông tin Bài đăng sự kiện bao gồm ngày và giờ bắt đầu và kết thúc, hiển thị nổi bật trên Bài đăng.

Để tạo Bài đăng với một tài khoản được liên kết với người dùng, hãy sử dụng accounts.locations.localPosts.

Để tạo một Bài đăng cho người dùng đã xác thực, hãy sử dụng các hàm sau:

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

Bài đăng kêu gọi hành động

Các bài đăng có lời kêu gọi hành động sẽ có một nút. Văn bản trong lời kêu gọi hành động nút do trường actionType của Bài đăng xác định. Một đường liên kết đến URL do người dùng cung cấp sẽ được thêm vào nút này.

Để tạo một Bài đăng có nút kêu gọi hành động, hãy làm như sau:

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

Loại hành động

Bài đăng kêu gọi hành động có thể có các loại hành động khác nhau để xác định loại về lời kêu gọi hành động trên Bài đăng.

Sau đây là các loại lời kêu gọi hành động được hỗ trợ:

Loại hành động
BOOK Tạo một Bài đăng nhắc người dùng đặt cuộc hẹn, đặt bàn hoặc nội dung tương tự.
ORDER Tạo một Bài đăng nhắc người dùng đặt món.
SHOP Tạo một bài đăng nhắc người dùng duyệt xem một sản phẩm danh mục nhạc phẩm.
LEARN_MORE Tạo một bài đăng nhắc người dùng xem thêm chi tiết về của bạn.
SIGN_UP Tạo một bài đăng nhắc người dùng đăng ký, đăng ký tài khoản hoặc tham gia một điều gì đó.
CALL Tạo một Bài đăng nhắc người dùng gọi điện cho một doanh nghiệp.

Bài đăng về ưu đãi

Để tạo một Bài đăng về ưu đãi, hãy sử dụng các thành phần sau:

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

Chỉnh sửa bài đăng

Sau khi tạo bài đăng, bạn có thể chỉnh sửa bài đăng đó bằng yêu cầu PATCH.

Để chỉnh sửa Bài đăng, hãy dùng các chức năng sau:

HTTP
$ PATCH
https://mybusiness.googleapis.com/v4/accounts/{accountId}/locations/{locationId}/localPosts/{localPostId}?updateMask=summary
{
  "summary": "Order your Christmas turkeys now!!"
}

Xoá bài đăng

Sau khi tạo một Bài đăng, bạn có thể xoá bài đăng đó bằng yêu cầu DELETE.

Để xoá một Bài đăng, hãy dùng cách sau:

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