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

API Google Doanh nghiệp của tôi giúp bạn tạo Bài đăng trong Google Tìm kiếm thuộc nhiều 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 đăng nhập 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ẽ có ngày và giờ bắt đầu cũng như ngày và giờ kết thúc, xuất hiện nổi bật trên Bài đăng.

Để đăng một bài viết 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 một bài đăng cho người dùng đã xác thực, hãy sử dụng nội dung 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 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. 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.

Để tạo bài đăng có nút kêu gọi hành động, hãy sử dụng những cách 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ó nhiều loại hành động, quyết định loại bài đăng 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 nội dung 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 chi tiết trên một trang web.
SIGN_UP Tạo một Bài đăng nhắc người dùng đăng ký, đăng nhập 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 doanh nghiệp.

Bài đăng về chương trình ư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 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 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 sử dụng nội dung sau:

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