Interfejs API ARCore Cloud Anchor Management

Zarządzanie elementami Cloud Anchors poza aplikacją ARCore za pomocą usługi ARCore Cloud Anchor Interfejs API zarządzania Google Analytics.

Pierwsze kroki

Przykładowe operacje

Autoryzacja

Utwórz klucz konta usługi w Konsola Google Cloud Platform i wygeneruj token OAuth2 do autoryzowania wywołań interfejsu Cloud Anchor Management API.

  1. W menu nawigacyjnym Konsola Google Cloud Platform, wybierz APIs & Services > Credentials

  2. Wybierz odpowiedni projekt i kliknij Create Credentials. Service account

  3. W sekcji Service account details wpisz nazwę nowego konta, a następnie kliknij Create.

  4. Na stronie Service account permissions przejdź do sekcji Select a role . Wybierz Service Accounts > Service Account Token Creator, i kliknij Continue.

  5. Na stronie Grant users access to this service account kliknij Done. Wrócisz do aplikacji APIs & Services > Credentials

  6. Przewiń stronę Credentials w dół do sekcji Service Accounts. i kliknij nazwę utworzonego konta.

  7. Przewiń stronę Service account details w dół do sekcji Keys. i wybierz Add Key > Create new key

  8. Wybierz JSON jako typ klucza i kliknij Create. Spowoduje to pobranie pliku JSON który zawiera klucz prywatny Twojego komputera. Przechowuj pobrany plik JSON w bezpiecznej lokalizacji.

Generowanie tokena OAuth2

arcore.management to zakres protokołu OAuth dla interfejsu Cloud Anchors Management API. Według domyślnie, oauth2l działa w pamięci podręcznej tokenów. Polecenie fetch pobiera te same dane token. Użyj oauth2l do wygenerowania OAuth2 token autoryzacji:

oauth2l fetch --json creds.json arcore.management

Aby wygenerować nowy token, dodaj opcję --cache="" do fetch .

oauth2l fetch --cache="" --json creds.json arcore.management

Możesz też wywołać funkcję oauth2l reset i ponownie wywołać polecenie fetch.

oauth2l reset
oauth2l fetch --json creds.json arcore.management

Wyświetlanie listy wszystkich kotwic Cloud

Pobierz pierwszą stronę zakotwiczonych w chmurze (opcjonalnie): expire_time, create_time lub last_localize_time.

Prośba:

export BEARER_TOKEN=`(oauth2l fetch --json creds.json arcore.management)`
curl -H "Authorization: Bearer $BEARER_TOKEN" \
   "https://arcore.googleapis.com/v1beta2/management/anchors?page_size=50&order_by=last_localize_time%20desc"

Odpowiedź:

{
  "anchors": [
    {
      "name": "anchors/ua-a1cc84e4f11b1287d289646811bf54d1",
      "createTime": "...",
      "expireTime": "...",
      "lastLocalizeTime": "...",
      "maximumExpireTime": "..."
    },
   …
    {
      "name": "anchors/ua-41a3d0233471917875159f6f3c25ea0e",
      "createTime": "...",
      "expireTime": "...",
      "lastLocalizeTime": "...",
      "maximumExpireTime": "..."
    }
  ],
  nextPageToken: "some-long-string"
}

Jeśli odpowiedź zwróci wartość nextPageToken, będzie dostępnych więcej reklam zakotwiczonych, z listy. Użyj w następnym żądaniu parametru zapytania next_page_token, aby go pobrać wyniki –

Prośba:

curl -H "Authorization: Bearer $BEARER_TOKEN" \
   "https://arcore.googleapis.com/v1beta2/management/anchors?page_size=50&order_by=last_localize_time%20desc&next_page_token=your-next-page-token-here"

Gdy używasz właściwości next_page_token, page_size i order_by muszą być spójne dla różnych żądań. page_size ma wartość domyślną 1000, a order_by to wartość domyślna expire_time_desc

Zmień czas życia kotwicy Cloud na maksymalny dozwolony czas

Wyślij żądanie pojedynczej kotwicy Cloud, która wyśle zapytanie do jej elementów lastLocalizeTime oraz maximumExpireTime

Prośba:

export BEARER_TOKEN=`(oauth2l fetch --json creds.json arcore.management)`
curl -H "Authorization: Bearer $BEARER_TOKEN" \
   "https://arcore.googleapis.com/v1beta2/management/anchors/your-anchor-id-here"

Odpowiedź:

{
  "name": "anchors/ua-f21be53fd8ea57f0169c69fbf827f6b7",
  "createTime": "2020-06-29T21:00:00Z",
  "expireTime": "2020-08-28T22:00:00Z",
  "lastLocalizeTime": "2020-06-29T21:00:00Z",
  "maximumExpireTime": "2021-06-29T21:00:00Z"
}

Po utworzeniu reklamy zakotwiczonej zmień expireTime na maximumExpireTime.

Prośba:

curl -H "Authorization: Bearer $BEARER_TOKEN" -H "Content-Type: application/json" -X "PATCH" \
   "https://arcore.googleapis.com/v1beta2/management/anchors/your-anchor-id-here?updateMask=expire_time" \
    -d '{ expireTime: "2021-06-29T21:00:00Z" }'

Odpowiedź:

{
  "name": "anchors/ua-f21be53fd8ea57f0169c69fbf827f6b7",
  "createTime": "2020-06-29T21:00:00Z",
  "expireTime": "2021-06-29T21:00:00Z",
  "lastLocalizeTime": "2020-06-29T21:00:00Z",
  "maximumExpireTime": "2021-06-29T21:00:00Z"
}

Usuwanie kotwic Cloud

Usuń pojedynczą kotwicę Cloud Anchor:

export BEARER_TOKEN=`(oauth2l fetch --json creds.json arcore.management)`
curl -H "Authorization: Bearer $BEARER_TOKEN" -X "DELETE" \
   "https://arcore.googleapis.com/v1beta2/management/anchors/your-anchor-id-here"

Usuń grupę Cloud Anchors:

export BEARER_TOKEN=`(oauth2l fetch --json creds.json arcore.management)`
curl -H "Authorization: Bearer $BEARER_TOKEN" -H "Content-Type: application/json" -X "POST" \
   "https://arcore.googleapis.com/v1beta2/management/anchors:batchDelete" \
    -d '{ names: [ "anchors/your-anchor-id-here", "anchors/your-anchor-id-here" ]}'