Ważne: nie przyjmujemy już nowych rejestracji w interfejsie Play EMM API. Więcej informacji

Ta strona została przetłumaczona przez Cloud Translation API.

Enterprises

Listę metod stosowanych w przypadku tego zasobu znajdziesz na końcu tej strony.

Reprezentacje zasobów

Zasób Enterprise reprezentuje powiązanie między usługą EMM a określoną organizacją. Powiązanie można utworzyć za pomocą tego interfejsu API na jeden z dwóch sposobów:

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 oraz konsoli interfejsów API Google) i przesyłanych do dostawcy usług EMM w mniej lub bardziej ręczny sposób.
W przypadku klientów korzystających z zarządzanych kont Google Play proces ten wymaga użycia Enterprises.generateSignupUrl i Enterprises.completeSignup w połączeniu z interfejsem rejestracji w zarządzanym Sklepie Google Play (mechanizmem udostępnianym przez Google), aby utworzyć powiązanie bez konieczności ręcznego wykonywania innych czynności.

Jako dostawca usług EMM możesz obsługiwać w konsoli EMM jedną z tych metod lub oba. Więcej informacji znajdziesz w artykule Tworzenie firmy.

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

nazwa usługi,	Wartość	Opis
`administrator[]`	`list`	Administratorzy w firmie. Ta funkcja jest obsługiwana tylko w przypadku firm utworzonych za pomocą procesu zainicjowanego w usługach EMM.
`administrator[].email`	`string`	Adres e-mail administratora.
`id`	`string`	Unikalny identyfikator firmy.
`kind`	`string`
`name`	`string`	Nazwa firmy, np. „Example sp. z o.o.”.
`primaryDomain`	`string`	Domena podstawowa firmy, na przykład „example.com”.

Metody

acknowledgeNotificationSet: Potwierdza powiadomienia otrzymywane od Enterprises.PullPowiadomieniaSet, aby w kolejnych wywołaniach nie były zwracane te same powiadomienia.
completeSignup: Kończy proces rejestracji, podając token ukończenia i token Enterprise. To żądanie nie może być wywoływane wiele razy dla danego tokena Enterprise.
createWebToken: Zwraca unikalny token dostępu do interfejsu użytkownika z możliwością umieszczania. Aby wygenerować interfejs internetowy, przekaż go do interfejsu JavaScript API zarządzanego Sklepu Google Play. Każdego tokena można użyć do uruchomienia tylko jednej sesji interfejsu użytkownika. Więcej informacji znajdziesz w dokumentacji interfejsu JavaScript API.
zarejestruj się: Rejestruje grupę z usługą EMM do połączeń telefonicznych.
generateSignupUrl: Generuje URL rejestracji.
pobierz: Pobiera nazwę i domenę firmy.
getServiceAccount: Zwraca konto usługi i dane logowania. Konto usługi można powiązać z firmą, wywołując funkcję setAccount. Konto usługi jest unikalne dla tej firmy i usług EMM i zostanie usunięte, jeśli firma nie będzie powiązana. Dane logowania zawierają dane klucza prywatnego i nie są przechowywane po stronie serwera.

Tę metodę można wywołać tylko po wywołaniu metody Enterprises.enroll lub Enterprises.CompleteSignup, ale przed Enterprises.SetAccount. W innych przypadkach zwraca ona błąd.

Kolejne wywołania po pierwszym wywołają nowy, unikalny zestaw danych logowania i unieważniają wcześniej wygenerowane dane logowania.

Gdy konto usługi zostanie powiązane z firmą, będzie można nim zarządzać za pomocą zasobu serviceAccountKeys.
getStoreLayout: Zwraca układ sklepu dla grupy. Jeśli układ sklepu nie został ustawiony, funkcja zwraca „podstawowy” jako typ układu sklepu i nie zwraca strony głównej.
list: Wyszukuje firmę według nazwy domeny. Ta funkcja jest obsługiwana tylko w przypadku firm utworzonych w ramach procesu tworzenia zainicjowanego przez Google. Wyszukiwanie identyfikatora nie jest wymagane w przypadku przedsiębiorstw utworzonych w ramach procesu inicjowanego w ramach usług EMM, ponieważ dane te są zapamiętywane w wywołaniu zwrotnym Enterprises.generateSignupUrl.
pullNotificationSet: Pobiera i zwraca zestaw powiadomień dla przedsiębiorstw powiązanych z kontem usługi uwierzytelnionym na potrzeby żądania. Zestaw powiadomień może być pusty, jeśli nie ma oczekującego powiadomienia.
Zwrócony zestaw powiadomień musi zostać potwierdzony w ciągu 20 sekund, wywołując Enterprises.Acknowledge NotificationSet, chyba że zestaw powiadomień jest pusty.
Powiadomienia, które nie zostaną potwierdzone w ciągu 20 sekund, zostaną ponownie uwzględnione w odpowiedzi na inne żądanie PullPowiadomieniaSet, a te, które nie zostaną potwierdzone, zostaną usunięte zgodnie z zasadami systemowymi Google Cloud Platform Pub/Sub.
Do pobrania powiadomień może być równocześnie wysyłanych wiele żądań. Jeśli takie powiadomienia są oczekujące, zostaną podzielone między każdego z nich.
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 powiadomienie testowe, aby zweryfikować integrację EMM z usługą Google Cloud Pub/Sub w tej grupie.
setAccount: Ustawia konto, które będzie używane do uwierzytelniania w interfejsie API jako konto firmowe.
setStoreLayout: Ustawia układ sklepu dla grupy. Domyślnie obiekt storeLayoutType jest ustawiony na „podstawowy” i włączony jest podstawowy układ sklepu. Podstawowy układ zawiera tylko aplikacje zatwierdzone przez administratora, które zostały dodane do zestawu usług dostępnych 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 (przez ustawienie parametrustoreUkładType = „custom” i ustawienie strony głównej), podstawowy układ sklepu będzie wyłączony.
wyrejestrować: Wyrejestrowuje firmę z usług EMM obsługujących połączenia.