- Yêu cầu HTTP
- Tham số đường dẫn
- Nội dung yêu cầu
- Nội dung phản hồi
- Phạm vi uỷ quyền
- CreateUserLinkRequest
- Hãy làm thử!
Tạo thông tin về các liên kết của nhiều người dùng với một tài khoản hoặc tài sản.
Phương thức này mang tính giao dịch. Nếu không tạo được bất kỳ UserLink nào, thì sẽ không có UserLink nào được tạo.
Yêu cầu HTTP
POST https://analyticsadmin.googleapis.com/v1alpha/{parent=accounts/*}/userLinks:batchCreate
URL sử dụng cú pháp Chuyển mã gRPC.
Tham số đường dẫn
Tham số | |
---|---|
parent |
Bắt buộc. Tài khoản hoặc tài sản mà tất cả người dùng liên kết trong yêu cầu đều được sử dụng. Trường này là bắt buộc. Trường gốc trong thông báo CreateUserLinkRequest phải trống hoặc khớp với trường này. Định dạng mẫu: accounts/1234 |
Nội dung yêu cầu
Nội dung yêu cầu chứa dữ liệu có cấu trúc sau:
Biểu diễn dưới dạng JSON |
---|
{
"notifyNewUsers": boolean,
"requests": [
{
object ( |
Trường | |
---|---|
notifyNewUsers |
Không bắt buộc. Nếu được đặt, hãy gửi email cho người dùng mới để thông báo rằng họ đã được cấp quyền đối với tài nguyên. Bất kể bạn có đặt giá trị này hay không, trường thông báoNewUser bên trong từng yêu cầu riêng lẻ sẽ bị bỏ qua. |
requests[] |
Bắt buộc. Các yêu cầu chỉ định đường liên kết người dùng cần tạo. Bạn có thể tạo tối đa 1.000 đường liên kết đến người dùng cùng một lúc. |
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 BatchCreateUserLinksResponse
.
Phạm vi uỷ quyền
Yêu cầu phạm vi OAuth sau:
https://www.googleapis.com/auth/analytics.manage.users
CreateUserLinkRequest
Yêu cầu thông báo cho userLinks.create RPC.
Người dùng có thể có nhiều địa chỉ email được liên kết với Tài khoản Google của họ và một trong các địa chỉ email này là địa chỉ email "chính". Bạn có thể sử dụng bất kỳ địa chỉ email nào được liên kết với Tài khoản Google cho UserLink mới, nhưng UserLink được trả về sẽ luôn chứa địa chỉ email "chính". Do đó, địa chỉ email đầu vào và đầu ra cho yêu cầu này có thể khác nhau.
Biểu diễn dưới dạng JSON |
---|
{
"parent": string,
"notifyNewUser": boolean,
"userLink": {
object ( |
Trường | |
---|---|
parent |
Bắt buộc. Định dạng mẫu: accounts/1234 |
notifyNewUser |
Không bắt buộc. Nếu được đặt, hãy gửi email cho người dùng mới thông báo rằng họ đã được cấp quyền đối với tài nguyên. |
userLink |
Bắt buộc. Đường liên kết người dùng để tạo. |