Method: accounts.userLinks.batchCreate

Tworzy informacje o połączeniach wielu użytkowników z kontem lub usługą.

Ta metoda ma charakter transakcyjny. Jeśli nie można utworzyć żadnych linków UserLink, nie zostaną utworzone żadne linki UserLink.

Żądanie HTTP

POST https://analyticsadmin.googleapis.com/v1alpha/{parent=accounts/*}/userLinks:batchCreate

Adres URL używa składni transkodowania gRPC.

Parametry ścieżki

Parametry
parent

string

Wymagane. Konto lub usługa, których dotyczą wszystkie połączenia użytkowników w prośbie. To pole jest wymagane. Pole nadrzędne w komunikatach CreateUserLinkRequest musi być puste lub zgodne z tym polem. Przykładowy format: accounts/1234

Treść żądania

Treść żądania zawiera dane o następującej strukturze:

Zapis JSON 
{
  "notifyNewUsers": boolean,
  "requests": [
    {
      object (CreateUserLinkRequest)
    }
  ]
}
Pola
notifyNewUsers

boolean

Opcjonalnie. Jeśli zasada jest skonfigurowana, wyślij do nowych użytkowników e-maila z powiadomieniem, że przyznano im uprawnienia do zasobu. Niezależnie od tego, czy ta zasada jest skonfigurowana, pole notificationNewUser w każdym żądaniu jest ignorowane.
requests[]

object (CreateUserLinkRequest)

Wymagane. Żądania określające linki użytkowników do utworzenia. Jednorazowo można utworzyć maksymalnie 1000 linków użytkowników.

Treść odpowiedzi

W przypadku powodzenia treść odpowiedzi obejmuje wystąpienie elementu BatchCreateUserLinksResponse.

Zakresy autoryzacji

Wymaga następującego zakresu OAuth:

  • https://www.googleapis.com/auth/analytics.manage.users

CreateUserLinkRequest

Komunikat RPC dotyczący metody userLinks.create.

Użytkownicy mogą mieć kilka adresów e-mail powiązanych ze swoim kontem Google, a jeden z nich jest „podstawowym” adresem e-mail. Każdy z adresów e-mail powiązanych z kontem Google może zostać użyty na potrzeby nowego elementu UserLink, ale zwrócony UserLink zawsze będzie zawierał „podstawowy” adres e-mail. W związku z tym może podany adres e-mail może się różnić.

Zapis JSON 
{
  "parent": string,
  "notifyNewUser": boolean,
  "userLink": {
    object (UserLink)
  }
}
Pola
parent

string

Wymagane. Przykładowy format: accounts/1234
notifyNewUser

boolean

Opcjonalnie. Jeśli zasada jest skonfigurowana, wyślij do nowego użytkownika e-maila z powiadomieniem, że przyznano mu uprawnienia do zasobu.