Method: accounts.locations.patch
Sử dụng bộ sưu tập để sắp xếp ngăn nắp các trang
Lưu và phân loại nội dung dựa trên lựa chọn ưu tiên của bạn.
Cập nhật vị trí đã chỉ định.
Chỉ cho phép ảnh trên vị trí có trang Google+.
Trả về NOT_FOUND
nếu vị trí không tồn tại.
Yêu cầu HTTP
PATCH https://mybusiness.googleapis.com/v4/{name=accounts/*/locations/*}
URL sử dụng cú pháp Chuyển mã gRPC.
Tham số đường dẫn
Các tham số |
name |
string
Tên của vị trí cần cập nhật.
|
Tham số truy vấn
Các tham số |
updateMask |
string (FieldMask format)
Các trường cụ thể cần cập nhật. Nếu không có mặt nạ nào được chỉ định, thì quá trình này được coi là cập nhật đầy đủ và tất cả các trường được đặt thành các giá trị được truyền vào, có thể bao gồm việc huỷ đặt các trường trống trong yêu cầu. Đây là danh sách các tên trường đủ điều kiện được phân tách bằng dấu phẩy. Ví dụ: "user.displayName,photo"
|
validateOnly |
boolean
Nếu đúng, yêu cầu sẽ được xác thực nhưng không thực sự cập nhật vị trí.
|
attributeMask |
string (FieldMask format)
Mã nhận dạng của các thuộc tính cần cập nhật. Chỉ các thuộc tính được ghi chú trong mặt nạ mới được cập nhật. Nếu một thuộc tính xuất hiện trong mặt nạ chứ không phải ở vị trí, thì thuộc tính đó sẽ bị xoá. Một mặt nạ trống sẽ cập nhật tất cả thuộc tính. Bất cứ khi nào bạn đặt trường này, updateMask sẽ bao gồm các thuộc tính làm một trong các trường cần cập nhật. Đây là danh sách các tên trường đủ điều kiện được phân tách bằng dấu phẩy. Ví dụ: "user.displayName,photo"
|
Nội dung yêu cầu
Nội dung yêu cầu chứa một bản sao của Location
.
Nội dung phản hồi
Nếu thành công, nội dung phản hồi sẽ chứa một phiên bản của Location
.
Phạm vi uỷ quyền
Yêu cầu một trong các phạm vi OAuth sau:
https://www.googleapis.com/auth/plus.business.manage
https://www.googleapis.com/auth/business.manage
Để biết thêm thông tin, hãy xem Tổng quan về OAuth 2.0.
Trừ phi có lưu ý khác, nội dung của trang này được cấp phép theo Giấy phép ghi nhận tác giả 4.0 của Creative Commons và các mẫu mã lập trình được cấp phép theo Giấy phép Apache 2.0. Để biết thông tin chi tiết, vui lòng tham khảo Chính sách trang web của Google Developers. Java là nhãn hiệu đã đăng ký của Oracle và/hoặc các đơn vị liên kết với Oracle.
Cập nhật lần gần đây nhất: 2025-07-25 UTC.
[[["Dễ hiểu","easyToUnderstand","thumb-up"],["Giúp tôi giải quyết được vấn đề","solvedMyProblem","thumb-up"],["Khác","otherUp","thumb-up"]],[["Thiếu thông tin tôi cần","missingTheInformationINeed","thumb-down"],["Quá phức tạp/quá nhiều bước","tooComplicatedTooManySteps","thumb-down"],["Đã lỗi thời","outOfDate","thumb-down"],["Vấn đề về bản dịch","translationIssue","thumb-down"],["Vấn đề về mẫu/mã","samplesCodeIssue","thumb-down"],["Khác","otherDown","thumb-down"]],["Cập nhật lần gần đây nhất: 2025-07-25 UTC."],[[["\u003cp\u003eThis document outlines how to update a specific Google My Business location using the \u003ccode\u003ePATCH\u003c/code\u003e HTTP request method.\u003c/p\u003e\n"],["\u003cp\u003eThe request requires specifying the location's name in the URL path and can include optional query parameters like \u003ccode\u003eupdateMask\u003c/code\u003e, \u003ccode\u003evalidateOnly\u003c/code\u003e, and \u003ccode\u003eattributeMask\u003c/code\u003e to control the update process.\u003c/p\u003e\n"],["\u003cp\u003eThe request body should contain a \u003ccode\u003eLocation\u003c/code\u003e object with the desired updates, and a successful response will return the updated \u003ccode\u003eLocation\u003c/code\u003e object.\u003c/p\u003e\n"],["\u003cp\u003eAuthorization is necessary and requires one of the specified OAuth scopes: \u003ccode\u003ehttps://www.googleapis.com/auth/plus.business.manage\u003c/code\u003e or \u003ccode\u003ehttps://www.googleapis.com/auth/business.manage\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003ePhotos can only be added to locations with an associated Google+ page, and attempting to update a non-existent location results in a \u003ccode\u003eNOT_FOUND\u003c/code\u003e error.\u003c/p\u003e\n"]]],["This describes updating a location using a `PATCH` request to the specified URL. The location is identified by its `name` in the path. Updates are controlled by the `updateMask` and `attributeMask` query parameters. A boolean `validateOnly` parameter allows for request validation without making changes. The request and response bodies both use a Location object. Authorization requires specific OAuth scopes. A location must have a Google+ page to be updated with photos, and requests for non-existent locations return `NOT_FOUND`.\n"],null,[]]