> ## Documentation Index
> Fetch the complete documentation index at: https://www.ayrshare.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Google Business Profile API

> Các tùy chọn để đăng bài bằng Google Business Profile API

export const PlansAvailable = ({plans = [], maxPackRequired}) => {
  let displayPlans = plans;
  if (plans && plans.length === 1) {
    const lowerCasePlan = plans[0].toLowerCase();
    if (lowerCasePlan === "business") {
      displayPlans = ["Launch", "Business", "Enterprise"];
    } else if (lowerCasePlan === "premium") {
      displayPlans = ["Premium", "Launch", "Business", "Enterprise"];
    }
  }
  return <Note>
Available on {displayPlans.length === 1 ? "the " : ""}
{displayPlans.join(", ").replace(/\b\w/g, l => l.toUpperCase())}{" "}
{displayPlans.length > 1 ? "plans" : "plan"}.

{maxPackRequired && <span onClick={() => window.open('https://www.ayrshare.com/docs/additional/maxpack', '_self')} className="flex items-center mt-2 cursor-pointer">
 <span className="px-1.5 py-0.5 rounded text-sm" style={{
    backgroundColor: '#C264B6',
    color: 'white',
    fontSize: '12px'
  }}>
   Max Pack required
 </span>
</span>}
</Note>;
};

## Đăng bài lên Google Business Profile

Có bốn loại bài đăng Google Business Profile, trước đây được gọi là Google My Business, có thể được tạo bằng Google Business Profile API.
Trong ví dụ dưới đây, nội dung `post` được đăng dưới dạng bản cập nhật lên trang Google business của người dùng.
[Tìm hiểu thêm](https://www.ayrshare.com/blog/google-my-business-what-is-gmb-why-you-need-it-and-how-to-use-it/) về Google Business Profile (GBP).

<Warning>
  Bạn phải [claim](https://support.google.com/business/answer/2911778) trang Google Business Profile của mình trước khi liên kết với Ayrshare. Hãy chắc chắn chọn tài khoản Google là admin của trang GBP trong quá trình cấp phép liên kết. Business profile cũng phải được xác minh và công khai.

  Bạn có thể truy cập bảng điều khiển quản lý GBP và kiểm tra trạng thái xác minh tại [https://business.google.com/](https://business.google.com/)
</Warning>

Bài đăng sản phẩm không thể được tạo qua Google Business Profile API vào thời điểm này.

JSON cho một bài đăng cơ bản chỉ với văn bản lên GBP, sẽ xuất hiện trong phần "What's New" của:

```json Google Business Profile Post theme={"system"}
{
  "post": "The best GMB ever #best https://www.google.com",
  "platforms": ["gmb"] // Please note to use `gmb`
}
```

hoặc JSON cho một bài đăng cơ bản với hình ảnh lên GBP:

```json Google Business Profile Post with Image theme={"system"}
{
  "post": "The best GMB ever #best https://www.google.com",
  "mediaUrls": ["https://img.ayrshare.com/012/gb.jpg"],
  "platforms": ["gmb"]
}
```

<ul class="custom-bullets">
  <li>
    Nếu video của bạn không kết thúc bằng phần mở rộng video đã biết như mp4, vui lòng sử dụng tham số `isVideo`.
    Xem [endpoint /post](/apis/post/overview) để biết chi tiết.
  </li>

  <li>
    Xem [Google Business Profile Media Guidelines](/media-guidelines/google_business_profile) và [Google Business Profile Authorization](/dashboard/connect-social-accounts/google-business) để biết thêm thông tin.
  </li>
</ul>

## Yêu cầu đăng bài Google Business Profile

Vui lòng đảm bảo bài đăng của bạn không chứa những nội dung sau. Google sẽ từ chối bài đăng và bài đăng sẽ hiển thị là "This post is no longer available" hoặc với nhãn "Rejected" trong Google Console:

<ul class="custom-bullets">
  <li>Số điện thoại. Google sẽ từ chối tất cả bài đăng chứa số điện thoại.</li>
  <li>Spam, tuyên bố sai sự thật, hoặc trình bày sai sự thật.</li>
  <li>Bài đăng lạc đề không liên quan đến doanh nghiệp của bạn.</li>
  <li>Nội dung trùng lặp.</li>
  <li>Nội dung không phù hợp.</li>
  <li>Ngôn ngữ xúc phạm.</li>
</ul>

Vui lòng xem [Chính sách nội dung của Google Business Profile](https://support.google.com/business/answer/7213077?hl=en) để biết thêm thông tin.

## Bài đăng tiêu chuẩn (What's New)

Một bài đăng địa phương tiêu chuẩn xuất hiện trong phần "*Posts*" của GBP và được phân loại là "What's New".
Nó có thể chứa nội dung bài đăng, hình ảnh, hoặc một Call to Action ([xem bên dưới](/apis/post/social-networks/google#call-to-action)).

Video không được hỗ trợ để xuất bản đến phần What's New qua Google Business Profile API.
Vui lòng xem [Bài đăng hình ảnh hoặc video](#image-or-video-post) để biết chi tiết về cách xuất bản video lên Google Business Profile.

*Các bài đăng này sẽ xuất hiện trong phần "**Posts -> What's New**" trong bảng điều khiển quản lý GMB.*

```json Google Business Profile Standard Post theme={"system"}
{
  "post": "A wonderful post",
  "platforms": ["gmb"],
  "mediaUrls": ["https://img.ayrshare.com/012/gb.jpg"], // optional - images only
  "gmbOptions": {
    "callToAction": {
      // optional
      "actionType": "learn_more",
      "url": "https://www.ayrshare.com"
    }
  }
}
```

## Bài đăng hình ảnh hoặc video

Bạn có thể xuất bản bài đăng Hình ảnh hoặc Video lên Google Business Profile.
Hình ảnh và video sẽ xuất hiện trong phần "**Photos**" trong bảng điều khiển quản lý GBP.

### Yêu cầu

<ul class="custom-bullets">
  <li>
    Chỉ một hình ảnh hoặc một video có thể được thêm vào vị trí GBP của bạn, sẽ xuất hiện trong phần
    "Photos" của bảng điều khiển GBP.
  </li>

  <li>Chỉ một hình ảnh hoặc video được phép cho mỗi bài đăng.</li>
  <li>Nội dung bài đăng được yêu cầu bởi endpoint, nhưng không được sử dụng bởi GBP.</li>
  <li>Call to Action không được hỗ trợ cho bài đăng hình ảnh hoặc video.</li>
  <li>Hãy chắc chắn bao gồm tham số `isPhotoVideo` trong đối tượng `gmbOptions`.</li>
</ul>

```json Google Business Profile Image Post {6} theme={"system"}
{
  "post": "What an image!",
  "platforms": ["gmb"],
  "mediaUrls": ["https://img.ayrshare.com/012/gb.jpg"], // required
  "gmbOptions": {
    "isPhotoVideo": true, //required
    "category": "product" // optional
  }
}
```

### Xử lý video

Đôi khi Google mất thêm thời gian để xử lý các video được tải lên.

Bạn có thể xem trạng thái của phương tiện trong bảng điều khiển Google Business Profile:

1. Truy cập [bảng điều khiển Google Business Profile](https://business.google.com/us/business-profile/) của bạn.
2. Nhấp vào nút "See your profile". Bạn sẽ được đưa đến trang GBP.
3. Nhấp vào tab "Photos".
4. Bạn sẽ thấy danh sách ảnh và video.
5. Nhấp vào ảnh hoặc video bạn muốn xem.

<Warning>
  Nếu video của bạn có trạng thái "pending", nó vẫn đang được Google xử lý. Vui lòng đợi vài
  phút và làm mới trang. Hãy chắc chắn Google Business Profile của bạn đã được xác minh và
  profile là công khai.

  Nếu video có vẻ bị kẹt ở "pending", điều này có thể do lỗi tại Google.
  Vui lòng liên hệ [Google Business support](https://support.google.com/business/gethelp) để được
  hỗ trợ.
</Warning>

### Danh mục sản phẩm

Bạn có thể chỉ định một danh mục sản phẩm cho hình ảnh hoặc video để phương tiện được phân loại trong phần "Photos" của bảng điều khiển GBP. Ví dụ, nếu một hình ảnh có danh mục "product", nó sẽ xuất hiện dưới tab "Product" trong Photos.

Một số danh mục không được phép đối với một số loại doanh nghiệp nhất định. Ví dụ, Ayrshare không thể sử dụng `food_and_drink` vì chúng tôi không thuộc ngành thực phẩm/đồ uống.

Các danh mục khả dụng:

<ul class="custom-bullets">
  <li>`cover`: Ảnh bìa. Một vị trí chỉ có một ảnh bìa.</li>
  <li>`profile`: Ảnh hồ sơ. Một vị trí chỉ có một ảnh hồ sơ.</li>
  <li>`logo`: Ảnh logo.</li>
  <li>`exterior`: Phương tiện bên ngoài.</li>
  <li>`interior`: Phương tiện bên trong.</li>
  <li>`product`: Phương tiện sản phẩm.</li>
  <li>`at_work`: Phương tiện tại nơi làm việc.</li>
  <li>`food_and_drink`: Phương tiện đồ ăn và thức uống.</li>
  <li>`menu`: Phương tiện thực đơn.</li>
  <li>`common_area`: Phương tiện khu vực chung.</li>
  <li>`rooms`: Phương tiện phòng.</li>
  <li>`teams`: Phương tiện đội ngũ.</li>
</ul>

## Bài đăng sự kiện

Quảng bá một sự kiện tại doanh nghiệp của bạn. Sự kiện yêu cầu tiêu đề, ngày bắt đầu và kết thúc, và có thể bao gồm video. Ví dụ, một đại lý bất động sản có thể quảng cáo buổi mở nhà.

<ul class="custom-bullets">
  <li>Sự kiện hỗ trợ Call to Action.</li>
  <li>Bao gồm một hình ảnh tùy chọn với tham số `mediaUrls`.</li>
  <li>Video không được hỗ trợ cho Sự kiện.</li>

  <li>
    Bài đăng sự kiện sẽ xuất hiện trong phần "**Posts -> Events**" trong bảng điều khiển quản lý GBP.
  </li>

  <li>Nội dung `post` sẽ được sử dụng cho Chi tiết Sự kiện.</li>
</ul>

```json Google Business Profile Event Post theme={"system"}
{
  "post": "A great event!", // Event Details
  "platforms": ["gmb"],
  "mediaUrls": ["https://img.ayrshare.com/012/gb.jpg"], // optional
  "gmbOptions": {
    "event": {
      "title": "Check this event out.", // required
      "startDate": "2021-08-12T20:17:46.384Z", // required
      "endDate": "2021-09-12T20:17:46.384Z" // required
    }
  }
}
```

## Bài đăng khuyến mãi

Cung cấp các chương trình giảm giá hoặc khuyến mãi từ doanh nghiệp của bạn. Khuyến mãi yêu cầu tiêu đề cũng như ngày và giờ bắt đầu và kết thúc. Một nút hành động "View offer" sẽ được tự động thêm vào bài đăng. Bạn cũng có thể bao gồm ảnh, mô tả, mã coupon, liên kết, và các điều khoản và điều kiện với bài đăng. Ví dụ, một cửa hàng đồ chơi có thể quảng cáo giảm 20% tất cả beanie babies trong một tuần.

Bao gồm hình ảnh với tham số `mediaUrls`.

*Video không được hỗ trợ cho Khuyến mãi.*

*Các bài đăng này sẽ xuất hiện trong phần "**Posts -> Offers**" trong bảng điều khiển quản lý GBP.*

```json Google Business Profile Offers Post theme={"system"}
{
  "post": "A great offer for everyone!",
  "platforms": ["gmb"],
  "gmbOptions": {
    "offer": {
      "title": "Great Sale.", // required
      "startDate": "2021-08-12T20:17:46.384Z", // required
      "endDate": "2021-09-12T20:17:46.384Z", // required
      "couponCode": "BOGO-JET-CODE", // required - max 58 characters
      "redeemOnlineUrl": "https://www.ayrshare.com", // required
      "termsConditions": "Offer only valid if you can prove you are a time traveler" // required
    }
  }
}
```

<ul class="custom-bullets">
  <li>`couponCode` có tối đa 58 ký tự.</li>
</ul>

## Call to Action

Cung cấp thông tin chung về doanh nghiệp của bạn và xuất hiện dưới dạng nút hành động. Ví dụ, một website có thể quảng bá nút *Learn More* để chuyển hướng đến website của họ.

Một Call to Action có thể được thêm vào bài đăng Tiêu chuẩn hoặc Sự kiện. Khuyến mãi không thể có Call to Actions.

Bao gồm hình ảnh với tham số `mediaUrls`.

```json Google Business Profile Call to Action Post theme={"system"}
{
  "post": "Take this action!",
  "platforms": ["gmb"],
  "mediaUrls": ["https://img.ayrshare.com/012/gb.jpg"], //optional
  "gmbOptions": {
    "callToAction": {
      "actionType": "order", // required
      "url": "https://www.ayrshare.com" // required for all action types but "call"
    }
  }
}
```

`actionType` được hiển thị dưới dạng nút trên bài đăng. Các giá trị có thể là:

<ul class="custom-bullets">
  <li>**book**: Nhắc người dùng đặt lịch hẹn, bàn, hoặc điều gì đó tương tự.</li>
  <li>**order**: Nhắc người dùng đặt hàng.</li>
  <li>**shop**: Nhắc người dùng duyệt một danh mục sản phẩm.</li>
  <li>**learn\_more**: Nhắc người dùng xem chi tiết bổ sung trên một website.</li>
  <li>**sign\_up**: Nhắc người dùng đăng ký, đăng ký, hoặc tham gia điều gì đó.</li>

  <li>
    **call**: Nhắc người dùng gọi cho một doanh nghiệp. Trường `url` không bắt buộc cho `call`.
    Tuy nhiên, trước tiên bạn phải đặt số điện thoại trong Google Business Profile để hành động
    gọi xuất hiện trên bài đăng.
  </li>
</ul>

Tham số `url` là URL mà người dùng sẽ được chuyển hướng đến khi nhấp vào.

Thêm [thông tin về Google Business Profile](https://www.ayrshare.com/blog/google-my-business-what-is-gmb-why-you-need-it-and-how-to-use-it/).

<Card title="Google Business Profile Linking" icon="link" href="/dashboard/connect-social-accounts/google-business" horizontal />

## Bình luận đầu tiên (First Comment)

Google Business Profile không hỗ trợ bình luận bài đăng, vì vậy tham số `firstComment` bị bỏ qua đối với các bài đăng chỉ dành cho Google Business Profile.
Một đối tượng warning/skip cho `firstComment` được trả về, nhưng bản thân bài đăng vẫn thành công, không có lỗi nào được đưa ra.

## Nhắc tên (Mention) trên Google Business Profile

Trong khi bạn có thể thêm `@handle` vào một bài đăng Google Business Profile, Google Business Profile không hỗ trợ giải quyết các nhắc tên trong nội dung bài đăng.
`@handle` sẽ vẫn là văn bản thuần túy.

## Giới hạn ký tự

Vui lòng xem [Giới hạn ký tự Google Business Profile](/help-center/technical-support/character_limits#google-business-profile-character-limits) để biết thêm thông tin.