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 korzystających z domeny zarządzanej przez Google proces polega na użyciu interfejsów Enterprises.enroll i Enterprises.setAccount (w połączeniu z elementami uzyskanymi z konsoli administracyjnej i Konsoli interfejsów API Google) oraz przesłaniu ich do EMM za pomocą mniej lub bardziej manualnego 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 dostarczany 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. Szczegółowe informacje 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 umieszczenia. Aby wygenerować interfejs internetowy, 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.
generateEnterpriseUpgradeUrl
Generuje adres URL uaktualnienia dla firm, aby przekształcić istniejącą grupę kont zarządzanego Sklepu Google Play w zarządzaną domenę Google. Więcej informacji znajdziesz w przewodniku na temat uaktualniania konta firmowego.
generateSignupUrl
Generuje URL do rejestracji.
get
Pobiera nazwę i domenę organizacji.
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 tego przedsiębiorstwa i EMM i zostanie usunięte, jeśli przedsiębiorstwo zostanie odwiązane. 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 organizacji 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 takim 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 parametr storeLayoutType ma wartość „basic” (podstawowy) i włącza 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 określając stronę główną), podstawowy układ sklepu zostanie wyłączony.
rezygnować z uczestnictwa
Wyrejestrowuje firmę z domenatującego EMM.