Zasób: Company
Sprzedawca, dostawca lub klient korzystający z interfejsów API dla sprzedawców i klientów korzystających z rejestracji typu zero-touch.
Zapis JSON |
---|
{ "name": string, "companyId": string, "companyName": string, "ownerEmails": [ string ], "adminEmails": [ string ], "termsStatus": enum ( |
Pola | |
---|---|
name |
Tylko dane wyjściowe. Nazwa zasobu interfejsu API firmy. Nazwa zasobu ma jeden z tych formatów:
Przypisana przez serwer. |
companyId |
Tylko dane wyjściowe. Identyfikator firmy. Przypisana przez serwer. |
companyName |
Wymagane. Nazwa firmy. Przykład: XYZ Corp. Wyświetlane pracownikom firmy w portalu rejestracji typu zero-touch. |
ownerEmails[] |
Wymagane. Tylko dane wejściowe. Adresy e-mail użytkowników klienta z rolą właściciela. Wymagany jest co najmniej 1 |
adminEmails[] |
Opcjonalnie: Adresy e-mail użytkowników klienta z rolą administratora. Każdy adres e-mail musi być powiązany z kontem Google. |
termsStatus |
Tylko dane wyjściowe. czy dowolny użytkownik z firmy zaakceptował najnowsze Warunki korzystania z usługi. Zobacz |
skipWelcomeEmail |
Tylko dane wejściowe. Jeśli ma wartość Prawda, e-mail powitalny nie jest wysyłany do klienta. Zalecamy pominięcie e-maila powitalnego w przypadku zgłoszenia własności urządzeń w ramach dodatkowej usługi DEVICE_PROTECTION, ponieważ klient otrzyma osobne e-maile w momencie zgłoszenia własności urządzenia. Jeśli to nie jest klient korzystający z rejestracji typu zero-touch, to pole jest ignorowane. |
languageCode |
Tylko dane wejściowe. Preferowany region klienta podany jako kod języka BCP47. To pole jest sprawdzane podczas wprowadzania danych, a żądania zawierające nieobsługiwane kody języka będą odrzucane. |
googleWorkspaceAccount |
Tylko dane wyjściowe. Konto Google Workspace powiązane z tym klientem. Używany tylko w przypadku firm klientów. |
TermsStatus
Akceptacja przez firmę Warunków korzystania z usługi rejestracji typu zero-touch. Jeden użytkownik może zaakceptować Warunki korzystania z usługi w swojej firmie w portalu internetowym.
Warunki korzystania z usługi mają różne wersje. Oznacza to, że po zmianie Warunków korzystania z usługi co najmniej 1 użytkownik musi je zaakceptować. Dopóki pierwszy użytkownik nie zaakceptuje nowych Warunków korzystania z usługi, stan warunków firmy będzie wynosić TERMS_STATUS_STALE
.
Wartości w polu enum | |
---|---|
TERMS_STATUS_NOT_ACCEPTED |
Żaden z użytkowników firmy nie zaakceptował Warunków korzystania z usługi. |
TERMS_STATUS_ACCEPTED |
Co najmniej jeden z użytkowników firmy zaakceptował Warunki korzystania z usługi. |
TERMS_STATUS_STALE |
Żaden z użytkowników firmy nie zaakceptował obecnych Warunków korzystania z usługi, ale przynajmniej jeden z nich zaakceptował poprzednie. |
GoogleWorkspaceAccount
jest klientem Google Workspace;
Zapis JSON |
---|
{ "customerId": string, "preProvisioningTokens": [ string ] } |
Pola | |
---|---|
customerId |
Wymagane. Identyfikator klienta. |
preProvisioningTokens[] |
Tylko dane wyjściowe. Tokeny wstępnej obsługi administracyjnej używane wcześniej do zgłaszania urządzeń. |
Metody |
|
---|---|
|
Tworzy klienta na potrzeby rejestracji typu zero-touch. |
|
Zawiera listę klientów zarejestrowanych u sprzedawcy określonego przez argument partnerId . |