Method: accounts.userLinks.batchCreate

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

string

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 (CreateUserLinkRequest)
    }
  ]
}
Trường
notifyNewUsers

boolean

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[]

object (CreateUserLinkRequest)

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 (UserLink)
  }
}
Trường
parent

string

Bắt buộc. Định dạng mẫu: accounts/1234
notifyNewUser

boolean

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.