Enterprises

Listę metod dotyczących tego zasobu znajdziesz na końcu tej strony.

Prezentacje zasobów

Zasób Enterprise reprezentuje powiązanie między rozwiązaniem EMM a konkretną organizacją. Powiązanie można utworzyć na 1 z 2 sposobów za pomocą tego interfejsu API:

• W przypadku klientów z domeną zarządzaną przez Google proces polega na użyciu interfejsów Enterprises.enroll i Enterprises.setAccount (w połączeniu z artefaktami uzyskanymi z konsoli administracyjnej i konsoli Google API) oraz przesłaniu ich do EMM za pomocą mniej lub bardziej ręcznego procesu.
• W przypadku klientów korzystających z zarządzanych kont Google Play proces ten polega na użyciu interfejsu Enterprises.generateSignupUrl i Enterprises.completeSignup w połączeniu z interfejsem rejestracji w zarządzanym Sklepie Google Play (mechanizm udostępniany przez Google) w celu utworzenia powiązania bez konieczności wykonywania ręcznych czynności.

Jako dostawca usług EMM możesz obsługiwać dowolną z tych metod lub obie w konsoli EMM. Więcej informacji znajdziesz w artykule Tworzenie konta Enterprise.

{
  "kind": "androidenterprise#enterprise",
  "id": string,
  "primaryDomain": string,
  "name": string,
  "administrator": [
    {
      "email": string
    }
  ],
  "enterpriseType": string,
  "managedGoogleDomainType": string
}

Nazwa usługi	Wartość	Opis	Uwagi
administrator[]	list	Administratorzy organizacji. Ta funkcja jest obsługiwana tylko w przypadku kont firmowych utworzonych za pomocą procesu inicjowanego przez EMM.
administrator[].email	string	Adres e-mail administratora.
enterpriseType	string	Typ przedsiębiorstwa. Akceptowane wartości: „enterpriseTypeUnspecified” „managedGoogleDomain” „managedGooglePlayAccountsEnterprise”
id	string	Unikalny identyfikator firmy.
kind	string
managedGoogleDomainType	string	Typ zarządzanej domeny Google Akceptowane wartości: „managedGoogleDomainTypeUnspecified” „typeDomain” „typeTeam”
name	string	Nazwa firmy, np. „Example, Inc.”
primaryDomain	string	Domena podstawowa firmy, np. „example.com”.

Metody

acknowledgeNotificationSet

Potwierdza powiadomienia otrzymane z Enterprises.PullNotificationSet, aby kolejne wywołania nie zwracały tych samych powiadomień.

completeSignup

Przechodzi proces rejestracji, podając token zakończenia i token dla firm. Nie można wywoływać tej funkcji wielokrotnie w przypadku danego tokena Enterprise.

createWebToken

Zwraca unikalny token umożliwiający dostęp do interfejsu do umieszczania. Aby wygenerować interfejs użytkownika w przeglądarce, przekaż wygenerowany token do zarządzanego interfejsu API JavaScript w Google Play. Każdy token może być używany tylko do rozpoczęcia jednej sesji interfejsu użytkownika. Więcej informacji znajdziesz w  dokumentacji interfejsu JavaScript API.

enroll

Rejestruje firmę w usługach EMM wywołującego dostawcy.

generateSignupUrl

Generuje adres URL do rejestracji.

get

Pobiera nazwę i domenę przedsiębiorstwa.

getServiceAccount

Zwraca konto usługi i dane logowania. Konto usługi można powiązać z organizacją, wywołując metodę setAccount. Konto usługi jest unikalne dla tej firmy i EMM i zostanie usunięte, jeśli firma zostanie odwiązana. Uwierzytelnianie zawiera dane klucza prywatnego i nie jest przechowywane po stronie serwera.

Metody tej można używać tylko po wywołaniu Enterprise.Enroll lub Enterprises.CompleteSignup i przed Enterprise.SetAccount. W innych przypadkach zwracany jest błąd.

Następne wywołania po pierwszym wygenerują nowy, unikalny zestaw danych logowania i unieważnią wcześniej wygenerowane dane logowania.

Po powiązaniu konta usługi z organizacją możesz nim zarządzać za pomocą zasobu serviceAccountKeys.

getStoreLayout

Zwraca układ sklepu dla firmy. Jeśli układ sklepu nie został ustawiony, zwraca „basic” jako typ układu sklepu i nie zwraca strony głównej.

list

Wyszukuje organizacji według nazwy domeny. Ta funkcja jest obsługiwana tylko w przypadku kont firmowych utworzonych za pomocą procesu tworzenia zainicjowanego przez Google. W przypadku firm utworzonych za pomocą procesu zainicjowanego przez EMM nie trzeba sprawdzać identyfikatora, ponieważ EMM uzyskuje identyfikator firmy w wywołaniu zwrotnym określonym w wywołaniu funkcji Enterprises.generateSignupUrl.

pullNotificationSet

Pobiera i zwraca zestaw powiadomień dla firm powiązanych z kontem usługi uwierzytelnionym na potrzeby żądania. Jeśli nie ma oczekujących powiadomień, zestaw powiadomień może być pusty.
Zwrócony zestaw powiadomień musi zostać potwierdzony w ciągu 20 sekund przez wywołanie funkcji Enterprises.AcknowledgeNotificationSet, chyba że zestaw powiadomień jest pusty.
Powiadomienia, które nie zostaną potwierdzone w ciągu 20 sekund, zostaną ponownie uwzględnione w odpowiedzi na kolejną prośbę o wyświetlenie zestawu powiadomień, a te, które nigdy nie zostaną potwierdzone, zostaną ostatecznie usunięte zgodnie z zasadami systemu Pub/Sub na platformie Google Cloud Platform.
Możliwe jest równoczesne wysyłanie wielu żądań powiadomień, w którym przypadku oczekujące powiadomienia (jeśli występują) zostaną rozdzielone między poszczególnych wywołujących.
Jeśli nie ma żadnych powiadomień, zwracana jest pusta lista powiadomień. Kolejne żądania mogą zwracać więcej powiadomień, gdy staną się dostępne.

sendTestPushNotification

Wysyła testowe powiadomienie, aby sprawdzić integrację EMM z usługą Google Cloud Pub/Sub w przypadku tego przedsiębiorstwa.

setAccount

Ustawia konto, które będzie używane do uwierzytelniania w interfejsie API jako przedsiębiorstwo.

setStoreLayout

Ustawia układ sklepu dla firmy. Domyślnie typ układu sklepu jest ustawiony na „basic” (podstawowy) i włączony jest podstawowy układ sklepu. Podstawowy układ zawiera tylko aplikacje zatwierdzone przez administratora i dodane do dostępnego zestawu usług dla użytkownika (za pomocą wywołania setAvailableProductSet). Aplikacje na stronie są posortowane według wartości identyfikatora produktu. Jeśli utworzysz niestandardowy układ sklepu (ustawiając storeLayoutType = „custom” i ustawiając stronę główną), podstawowy układ sklepu zostanie wyłączony.

rezygnować z uczestnictwa

Wyrejestrowuje firmę z domenatującego EMM.