Enterprises

Listę metod dla tego zasobu znajdziesz na końcu tej strony.

Reprezentacje zasobów

Zasób Enterprise reprezentuje powiązanie między dostawcą usług EMM a konkretną organizacją. To powiązanie można utworzyć na 2 sposoby za pomocą tego interfejsu API w następujący sposób:

  • W przypadku klientów korzystających z domen zarządzanych przez Google proces obejmuje użycie Enterprises.enroll i Enterprises.setAccount (w połączeniu z artefaktami uzyskanymi z konsoli administracyjnej i konsoli interfejsów API Google) oraz przesłanie ich do usług EMM w ramach bardziej lub mniej ręcznego procesu.
  • W przypadku klientów korzystających z zarządzanych kont Google Play proces wymaga użycia elementów Enterprises.generateSignupUrl i Enterprises.completeSignup w połączeniu z interfejsem rejestracji w zarządzanym Sklepie Google Play (mechanizm udostępniony przez Google) w celu utworzenia powiązania bez konieczności ręcznego wykonywania czynności.
Jako dostawca usług EMM w konsoli EMM możesz obsługiwać jedno z tych rozwiązań lub obie. Więcej informacji znajdziesz w artykule Tworzenie przedsiębiorstwa. 

{
  "kind": "androidenterprise#enterprise",
  "id": string,
  "primaryDomain": string,
  "name": string,
  "administrator": [
    {
      "email": string
    }
  ]
}
Nazwa usługi Wartość Opis Uwagi
administrator[] list Administratorzy firmy. Ta funkcja jest obsługiwana tylko w przypadku firm utworzonych za pomocą procesu inicjowanego przez usługi EMM.

administrator[].email string Adres e-mail administratora.
id string Unikalny identyfikator firmy.

kind string
name string Nazwa firmy, na przykład „Example sp. z o.o.”.
primaryDomain string Domena podstawowa firmy, na przykład „example.com”.

Metody

acknowledgeNotificationSet
Potwierdza powiadomienia otrzymywane od Enterprises.PullPowiadomSet, aby zapobiec zwracaniu kolejnych wywołań. te same powiadomienia.
completeSignup
Kończy proces rejestracji, określając token ukończenia i Token Enterprise. To żądanie nie może być wywoływane wiele razy w przypadku danej firmy Token.
createWebToken
Zwraca unikalny token dostępu do interfejsu z możliwością umieszczenia. Aby wygenerować interfejsu internetowego, przekaż wygenerowany token do kodu JavaScript zarządzanego Sklepu Google Play API. Każdego tokena można użyć tylko do uruchomienia 1 sesji interfejsu użytkownika. Zobacz dokumentacji JavaScript API.
zarejestruj się
Rejestruje firmę świadczącą usługi EMM.
generateSignupUrl
Generuje adres URL rejestracji.
pobierz
Pobiera nazwę i domenę przedsiębiorstwa.
getServiceAccount
Zwraca konto usługi i dane logowania. Konto usługi można powiązać z firmą przez wywołanie setAccount. Konto usługi jest unikalne dla tej firmy i usług EMM. Zostanie usunięte, jeśli nie jest przywiązany. Dane uwierzytelniające zawierają dane klucza prywatnego i nie są przechowywane po stronie serwera.

Tę metodę można wywołać dopiero po wywołaniu Enterprises.enroll lub Enterprises.CompleteSignup lub przed Enterprises.SetAccount; a w innych przypadkach – zwraca komunikat o błędzie.

Kolejne wywołania po pierwszym generują nowy, unikalny zestaw danych logowania oraz unieważnić wygenerowane wcześniej dane logowania.

Gdy konto usługi zostanie powiązane z firmą, będzie można nim zarządzać przy użyciu zasobu serviceAccountKeys.
getStoreLayout
Zwraca układ sklepu dla przedsiębiorstwa. Jeśli układ sklepu nie został ustawiony, zwraca wartość „podstawowy” jako typ układu sklepu, a nie jako stronie głównej.
list
Wyszukuje firmę według nazwy domeny. Ta funkcja jest obsługiwana tylko w przypadku firm utworzonych za pomocą proces tworzenia. W przypadku firm utworzonych za pomocą procesu zainicjowanego przez dostawcę usług EMM, ponieważ uczy się on identyfikatora firmy wywołanie zwrotne określone w wywołaniu Enterprises.generateSignupUrl.
pullNotificationSet
Pobiera i zwraca zestaw powiadomień dla firm powiązanych z adresem konto usługi uwierzytelnione dla tego żądania. Ustawione powiadomienia mogą jest puste, jeśli nie ma żadnych oczekujących powiadomień.
Zwrócony zestaw powiadomień musi zostać potwierdzony w ciągu 20 sekund przez wywołanie Enterprises.Acknowledge NotificationSet, chyba że zestaw powiadomień jest pusty.
Powiadomienia, które nie zostaną potwierdzone w ciągu 20 sekund, które mogą zostać ponownie uwzględnione w odpowiedzi na inny element PullPowiadomSet. a te, które nie zostały potwierdzone, zostaną w ostatecznym rozrachunku usunięte zgodnie z zasadami dotyczącymi systemu Pub/Sub w Google Cloud Platform.
W celu pobrania można wykonywać wiele żądań jednocześnie. Powiadomienia, które to oznacza, że oczekujące powiadomienia (jeśli są) zostaną podzieloną między każdego wywołującego, jeśli istnieją jakieś oczekujące.
W przypadku braku powiadomień zwracana jest pusta lista powiadomień. Kolejne żądania mogą zwracać więcej powiadomień, gdy tylko się pojawią. i dostępności informacji.
sendTestPushNotification
Wysyła powiadomienie testowe, aby zweryfikować integrację EMM w usłudze Google Cloud Pub/Sub dla danej firmy.
setAccount
Ustawia konto, które będzie używane do uwierzytelniania w interfejsie API jako firmy.
setStoreLayout
Konfiguruje układ sklepu dla firmy. Domyślnie storeLayoutType jest ustawiony na „podstawowy” a podstawowy układ sklepu jest włączony. Podstawowe zawiera tylko aplikacje zatwierdzone przez administratora i zawierające zostały dodane do zestawu produktów dostępnego dla użytkownika (za pomocą setAvailableProductSet). Aplikacje na stronie są posortowane w kolejności swoją wartość identyfikatora produktu. Jeśli utworzysz niestandardowy układ sklepu (przez ustawienie storeLayoutType = "custom" i ustawienie strony głównej), podstawowej wersji sklepu, układ jest wyłączony.
wyrejestruj się
Wyrejestrowuje firmę z połączonego dostawcy usług EMM.