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 sẽ hướng dẫn 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 phần 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 một Bài đăng. Bài đăng của bạn về một sự kiện sẽ bao gồm ngày và giờ bắt đầu cũng như kết thúc, được hiển thị nổi bật trên Bài đăng.

Để đăng một bài đăng lên tài khoản được 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 một người dùng đã xác thực, hãy sử dụng 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 có lời kêu gọi hành động

Bài đăng có lời kêu gọi hành động sẽ có 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 một URL do người dùng cung cấp sẽ được thêm vào nút.

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

Bài đăng có lời kêu gọi hành động có thể có nhiều loại hành động xác định loại bài đăng có lời kêu gọi hành độ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 lịch hẹn, đặt bàn hoặc làm một việc tương tự.
ORDER Tạo một 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 một Bài đăng nhắc người dùng xem thêm thông tin trên một trang web.
SIGN_UP Tạo một Bài đăng nhắc người dùng đăng ký, đăng ký hoặc tham gia một hoạt động nào đó.
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 Bài đăng ưu đãi, hãy sử dụng những thông tin 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 một bài đăng, bạn có thể chỉnh sửa bài đăng đó bằng một yêu cầu PATCH.

Để chỉnh sửa một Bài đăng, hãy làm như 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 làm như sau:

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