Enterprises

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

Prezentacje zasobów

Zasób Enterprises reprezentuje powiązanie między platformą EMM a konkretną organizacją. Powiązanie można utworzyć na 2 sposoby za pomocą tego interfejsu API:

  • W przypadku klientów korzystających z domen zarządzanych przez Google proces ten 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 EMM w ramach mniej więcej ręcznego procesu.
  • W przypadku klientów korzystających z kont w zarządzanym Sklepie Google Play proces ten polega na użyciu 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 wykonywania ręcznych czynności.
Jako dostawca usług EMM możesz obsługiwać w konsoli EMM jedną z tych metod lub obie. Więcej informacji znajdziesz w artykule Tworzenie organizacji. 

{
  "kind": "androidenterprise#enterprise",
  "id": string,
  "primaryDomain": string,
  "name": string,
  "administrator": [
    {
      "email": string
    }
  ],
  "googleAuthenticationSettings": {
    "googleAuthenticationRequired": string,
    "dedicatedDevicesAllowed": string,
    "createdAt": {
      "seconds": long,
      "nanos": integer
    },
    "updatedAt": {
      "seconds": long,
      "nanos": integer
    }
  },
  "enterpriseType": string,
  "managedGoogleDomainType": string
}
Nazwa usługi Wartość Opis Uwagi
administrator[] list administratorzy firmy; Jest to obsługiwane tylko w przypadku firm utworzonych w ramach procesu zainicjowanego przez EMM.

administrator[].email string Adres e-mail administratora.
enterpriseType string Rodzaj przedsiębiorstwa.

Akceptowane wartości:
  • „enterpriseTypeUnspecified”
  • „managedGoogleDomain”
  • „managedGooglePlayAccountsEnterprise”
googleAuthenticationSettings nested object Ustawienia uwierzytelniania użytkowników zapewnianego przez Google.
googleAuthenticationSettings.createdAt nested object Sygnatura czasowa utworzenia lub zmodyfikowania ustawień.
googleAuthenticationSettings.createdAt.nanos integer Nieujemne ułamki sekundy w rozdzielczości nanosekundowej. Ujemne wartości sekund z ułamkami muszą nadal mieć nieujemne wartości nanosekund, które liczą czas do przodu. Wartość musi mieścić się w zakresie od 0 do 999 999 999 włącznie.
googleAuthenticationSettings.createdAt.seconds long Reprezentuje sekundy czasu UTC od epoki uniksowej 1970-01-01T00:00:00Z. Musi mieścić się w zakresie od 0001-01-01T00:00:00Z do 9999-12-31T23:59:59Z włącznie.
googleAuthenticationSettings.dedicatedDevicesAllowed string Czy urządzenia specjalne są dozwolone.

Akceptowane wartości:
  • „allowed”
  • „dedicatedDevicesAllowedUnspecified”
  • „disallowed”
googleAuthenticationSettings.googleAuthenticationRequired string określ, czy wymagane jest uwierzytelnianie Google;

Akceptowane wartości:
  • „googleAuthenticationRequiredUnspecified”
  • „notRequired”
  • „required”
googleAuthenticationSettings.updatedAt nested object Sygnatura czasowa ostatniej modyfikacji ustawień.
googleAuthenticationSettings.updatedAt.nanos integer Nieujemne ułamki sekundy w rozdzielczości nanosekundowej. Ujemne wartości sekund z ułamkami muszą nadal mieć nieujemne wartości nanosekund, które liczą czas do przodu. Wartość musi mieścić się w zakresie od 0 do 999 999 999 włącznie.
googleAuthenticationSettings.updatedAt.seconds long Reprezentuje sekundy czasu UTC od epoki uniksowej 1970-01-01T00:00:00Z. Musi mieścić się w zakresie od 0001-01-01T00:00:00Z do 9999-12-31T23:59:59Z włącznie.
id string Unikalny identyfikator przedsiębiorstwa.

id string Unikalny identyfikator przedsiębiorstwa.

kind string
managedGoogleDomainType string Typ zarządzanej domeny Google.

Akceptowane wartości to:
  • „managedGoogleDomainTypeUnspecified”
  • „typeDomain”
  • „typeTeam”
name string Nazwa przedsiębiorstwa, np. „Example sp. z o.o.”.
primaryDomain string Domena podstawowa przedsiębiorstwa, np. „example.com”.

Metody

acknowledgeNotificationSet
Potwierdza powiadomienia otrzymane z usług dla firm.Wywołuje funkcję PullNotificationSet, aby zapobiec zwracaniu tych samych powiadomień w kolejnych wywołaniach.
completeSignup
Kończy proces rejestracji, podając token zakończenia i token przedsiębiorstwa. W przypadku danego tokena Enterprise nie można wywoływać tego żądania wielokrotnie.
createWebToken
Zwraca unikalny token umożliwiający dostęp do interfejsu, który można umieścić na stronie. Aby wygenerować interfejs internetowy, przekaż wygenerowany token do interfejsu JavaScript API zarządzanego Sklepu Google Play. Każdy token może być użyty tylko do rozpoczęcia jednej sesji interfejsu. Więcej informacji znajdziesz w  dokumentacji interfejsu JavaScript API.
zarejestruj
Rejestruje firmę u dostawcy usług EMM, który umożliwia połączenia.
generateEnterpriseUpgradeUrl
Generuje adres URL uaktualnienia grupy, który umożliwia przekształcenie istniejącej grupy kont zarządzanego Sklepu Google Play w zarządzaną domenę Google. Więcej informacji znajdziesz w przewodniku po uaktualnianiu wersji Enterprise.
generateSignupUrl
Generuje adres URL rejestracji.
get
Pobiera nazwę i domenę przedsiębiorstwa.
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ługi EMM i zostanie usunięte, jeśli firma zostanie odłączona. Dane logowania zawierają dane klucza prywatnego i nie są przechowywane po stronie serwera.

Tę metodę można wywołać tylko po wywołaniu metod Enterprises.Enroll lub Enterprises.CompleteSignup i przed wywołaniem metody Enterprises.SetAccount. W innych przypadkach zwróci ona błąd.

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

Gdy konto usługi zostanie powiązane z przedsiębiorstwem, można 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 brak strony głównej.
list
Wyszukuje firmę według nazwy domeny. Jest to obsługiwane tylko w przypadku firm utworzonych w ramach przepływu tworzenia zainicjowanego przez Google. W przypadku firm utworzonych w procesie zainicjowanym przez EMM wyszukiwanie identyfikatora nie jest potrzebne, ponieważ EMM poznaje identyfikator firmy w wywołaniu zwrotnym określonym w wywołaniu Enterprises.generateSignupUrl.
pullNotificationSet
Pobiera i zwraca zestaw powiadomień dla firm powiązanych z kontem usługi uwierzytelnionym na potrzeby żądania. Zbiór powiadomień może być pusty, jeśli nie ma oczekujących powiadomień.
Zwrócony zestaw powiadomień musi zostać potwierdzony w ciągu 20 sekund przez wywołanie Enterprises.AcknowledgeNotificationSet, chyba że zestaw powiadomień jest pusty.
Powiadomienia, które nie zostaną potwierdzone w ciągu 20 sekund, zostaną ostatecznie ponownie uwzględnione w odpowiedzi na inną prośbę PullNotificationSet, a te, które nigdy nie zostaną potwierdzone, zostaną ostatecznie usunięte zgodnie z zasadami systemu Google Cloud Platform Pub/Sub.
Aby pobrać powiadomienia, można wykonać kilka żądań jednocześnie. W takim przypadku oczekujące powiadomienia (jeśli takie są) zostaną podzielone 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 powiadomienie testowe, aby sprawdzić integrację EMM z usługą Google Cloud Pub/Sub w tej firmie.
setAccount
Ustawia konto, które będzie używane do uwierzytelniania w interfejsie API jako przedsiębiorstwo.
setStoreLayout
Ustawia układ sklepu dla przedsiębiorstwa. Domyślnie parametr storeLayoutType ma wartość „basic”, a podstawowy układ sklepu jest włączony. Układ podstawowy zawiera tylko aplikacje zatwierdzone przez administratora i dodane do zestawu dostępnych produktów 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 stronę główną), podstawowy układ sklepu zostanie wyłączony.
unenroll
Wyrejestrowuje firmę z usługi EMM do połączeń.