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 trên 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 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 xác thực OAuth 2.0.

Để biết thông tin 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 Thiết lập cơ bản.

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 Bài đăng. Bài đăng của bạn cho một 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 lên tài khoản liên kết với người dùng, hãy sử dụng API accounts.locations.localPosts.

Để tạo Bài đăng cho người dùng đã xác thực, hãy sử dụng các lệnh 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

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

Để tạo Bài đăng có nút kêu gọi hành động, hãy sử dụng các công cụ 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 thao tác

Lời kêu gọi hành động Bài đăng có thể có các loại hành động khác nhau giúp xác định loại lời kêu gọi hành động của Bài đăng.

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

Loại thao tác
BOOK Tạo một bài đăng nhắc người dùng đặt lịch hẹn, đặt bàn hoặc dịch vụ tương tự.
ORDER Tạo bài đăng nhắc người dùng đặt hàng.
SHOP Tạo một Bài đăng nhắc người dùng duyệt xem danh mục sản phẩm.
LEARN_MORE Tạo Bài đăng nhắc người dùng xem thêm thông tin chi tiết trên một trang web.
SIGN_UP Tạo Bài đăng nhắc người dùng đăng ký, đăng ký hoặc tham gia nội dung nào đó.
CALL Tạo 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 Bài đăng về ưu đãi, hãy sử dụng:

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 cách gửi yêu cầu PATCH.

Để chỉnh sửa Bài đăng, hãy sử dụng các thao tác 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 Bài đăng, bạn có thể xoá bài đăng đó bằng cách yêu cầu DELETE.

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

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