Skip to main content
PATCH
Cập nhật người dùng
Cập nhật dữ liệu tài khoản hoặc người dùng của mạng xã hội. Hiện tại hỗ trợ Google Business Profile và WhatsApp.
Google giới hạn việc cập nhật một số trường vị trí Google Business Profile chỉ được cập nhật 5 lần trong khoảng thời gian 24 giờ. Ví dụ, cập nhật phoneNumbers hơn 5 lần trong khoảng thời gian 24 giờ sẽ trả về Response 400. Giới hạn này chỉ áp dụng cho Google Business Profile và không áp dụng cho WhatsApp.

Tham số Header

Tham số Path

string
bắt buộc
Giá trị: gbp, whatsapp

Tham số Body

object
Đối tượng chứa các số điện thoại khác nhau mà khách hàng có thể sử dụng để liên lạc với doanh nghiệp.
string
Định danh Google cho vị trí này trong biểu mẫu.
string
Một số điện thoại thay thế để hiển thị trên AdWords location extensions thay vì số điện thoại chính của vị trí.
string
Định danh bên ngoài cho vị trí này, phải là duy nhất trong một tài khoản nhất định. Đây là một cách để liên kết vị trí với hồ sơ của bạn.
string
Tên vị trí phải phản ánh tên thực tế của doanh nghiệp, được sử dụng nhất quán trên mặt tiền cửa hàng, trang web và văn phòng phẩm, và được khách hàng biết đến.
string
Một URL cho doanh nghiệp này.
array
Một tập hợp các chuỗi tự do để cho phép bạn gắn thẻ doanh nghiệp. Các nhãn này không hiển thị với người dùng; chỉ bạn mới có thể nhìn thấy chúng. Phải từ 1-255 ký tự cho mỗi nhãn.
object
Một đối tượng đại diện cho cặp latitude/longitude. Điều này được biểu thị dưới dạng cặp doubles để biểu diễn độ vĩ độ và độ kinh độ. Trừ khi được chỉ định khác, đối tượng này phải tuân theo tiêu chuẩn WGS84.
Các giá trị phải nằm trong phạm vi chuẩn hóa.Vĩ độ tính bằng độ. Phải nằm trong khoảng [-90.0, +90.0].Kinh độ tính bằng độ. Phải nằm trong khoảng [-180.0, +180.0].
object
Trường này chứa mô tả về vị trí bằng giọng nói của riêng bạn. Mô tả không thể được chỉnh sửa bởi bất kỳ ai khác.

WhatsApp

WhatsApp đang trong Private Beta. Việc cập nhật một hồ sơ doanh nghiệp WhatsApp yêu cầu một tài khoản đã được phê duyệt cho WhatsApp. Nếu bạn muốn truy cập sớm, hãy gửi email đến lotty@ayrshare.com.
Chỉ gửi các trường bạn muốn thay đổi. Cần ít nhất một trường, và việc gửi một trường mà endpoint này không nhận ra sẽ khiến toàn bộ yêu cầu bị từ chối. Để xóa một trường, hãy gửi nó dưới dạng chuỗi rỗng: {"description": ""} xóa mô tả, và trường đó sau đó sẽ không còn xuất hiện trong hồ sơ nữa. Cách này áp dụng cho description, address và email. Nó không áp dụng cho about, trường mà WhatsApp yêu cầu phải có ít nhất một ký tự — để thay đổi trường đó, hãy ghi đè nó. vertical cũng không thể bị xóa một khi đã được đặt. Các trường phản hồi messaging_product và profile_picture_url (xem Hồ sơ doanh nghiệp WhatsApp) là chỉ đọc: gửi lại bất kỳ trường nào trong hai trường này sẽ bị từ chối như một trường không được nhận ra. Sử dụng profilePictureUrl để đặt ảnh.
string
Văn bản hiển thị bên dưới ảnh hồ sơ. 1–139 ký tự. Đây là trường văn bản duy nhất WhatsApp không cho phép bạn xóa — thay vào đó hãy ghi đè nó.
string
Mô tả doanh nghiệp. Tối đa 512 ký tự. Gửi "" để xóa nó.
string
Địa chỉ doanh nghiệp. Tối đa 256 ký tự. Gửi "" để xóa nó.
string
Địa chỉ email liên hệ. Tối đa 128 ký tự, và phải là một địa chỉ hợp lệ trừ khi bạn đang gửi "" để xóa nó.
array
Một mảng không rỗng gồm tối đa 2 URL, mỗi URL bắt đầu bằng http:// hoặc https://.
string
Danh mục doanh nghiệp. WhatsApp hiện chấp nhận: OTHER, AUTO, BEAUTY, APPAREL, EDU, ENTERTAIN, EVENT_PLAN, FINANCE, GROCERY, GOVT, HOTEL, HEALTH, NONPROFIT, PROF_SERVICES, RETAIL, TRAVEL, RESTAURANT, ALCOHOL, ONLINE_GAMBLING, PHYSICAL_GAMBLING, OTC_DRUGS, MATRIMONY_SERVICE. Danh sách này là của WhatsApp và có thể mở rộng theo thời gian — Ayrshare không hạn chế giá trị, vì vậy bất kỳ danh mục nào WhatsApp chấp nhận đều hoạt động. Giá trị được chuẩn hóa thành chữ hoa, nên một giá trị được gửi dưới dạng retail sẽ được trả về dưới dạng RETAIL. WhatsApp không cho phép xóa danh mục một khi nó đã được đặt, và từ chối một giá trị mà nó không chấp nhận — sự từ chối được trả về dưới dạng 101 kèm thông báo của chính WhatsApp nêu tên các giá trị hiện được chấp nhận.
string
Một ảnh JPEG hoặc PNG có thể truy cập công khai, 5 MB hoặc nhỏ hơn. Hình ảnh phải là hình vuông và ít nhất 192×192 — khuyến nghị 640×640. Không có độ phân giải tối đa: một hình ảnh lớn hơn được chấp nhận và được WhatsApp thu nhỏ lại. Một hình ảnh không vuông hoặc dưới 192×192 sẽ bị từ chối với một 400 nêu rõ vấn đề, trước khi bất cứ thứ gì được gửi đến WhatsApp. Xem nguyên tắc phương tiện WhatsApp để biết đầy đủ các yêu cầu.