Method: accounts.userLinks.batchCreate

Umożliwia tworzenie informacji o połączeniach wielu użytkowników z kontem lub usługą.

Ta metoda jest transakcyjna. Jeśli nie można utworzyć linku UserLink, nie zostanie utworzony żaden z linków 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

To pole jest 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 pasować do tego pola. 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 jest włączona, wyślij do nowych użytkowników e-maila z powiadomieniem, że przyznano im uprawnienia do zasobu. Bez względu na to, czy ta wartość jest ustawiona czy nie, pole notificationNewUser w każdym żądaniu jest ignorowane.

requests[]

object (CreateUserLinkRequest)

To pole jest wymagane. Żądania określające linki użytkowników do utworzenia. Maksymalnie można utworzyć 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 z żądaniem wywołania RPC userLinks.create.

Użytkownicy mogą mieć wiele adresów e-mail powiązanych ze swoim kontem Google, z których jeden jest „podstawowym” adresem e-mail. Na potrzeby nowego linku UserLink można użyć dowolnego z adresów e-mail powiązanych z kontem Google, ale zwrócony UserLink zawsze będzie zawierał „podstawowy” adres e-mail. W związku z tym wejściowy i wyjściowy adres e-mail może się różnić.

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

string

To pole jest 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.