ARCore क्लाउड ऐंकर मैनेजमेंट एपीआई

ARCore क्लाउड ऐंकर मैनेजमेंट एपीआई का इस्तेमाल करके, अपने ARCore ऐप्लिकेशन से बाहर क्लाउड ऐंकर मैनेज करें.

रिपोर्ट का इस्तेमाल करना

• अनुमति देना
• OAuth2 टोकन जनरेट करना

उदाहरण संक्रियाएं

• सभी Cloud ऐंकर की सूची बनाएं
• क्लाउड ऐंकर के समय को, तय की गई अवधि के मुताबिक अपडेट करना
• क्लाउड ऐंकर मिटाएं

अनुमति देना

Google Cloud Platform कंसोल में सेवा खाता कुंजी बनाएं और Cloud anchor management API कॉल की अनुमति देने के लिए OAuth2 टोकन जनरेट करें.

1. Google Cloud Platform कंसोल के नेविगेशन मेन्यू में, APIs & Services > Credentials पर जाएं.

2. अपनी पसंद का प्रोजेक्ट चुनें. इसके बाद, Create Credentials > Service account पर क्लिक करें.

3. Service account details में जाकर, नए खाते का नाम लिखें, फिर Create पर क्लिक करें.

4. Service account permissions पेज पर, Select a role ड्रॉपडाउन पर जाएं. Service Accounts > Service Account Token Creator को चुनकर, Continue पर क्लिक करें.

5. Grant users access to this service account पेज पर जाकर, Done पर क्लिक करें. यह आपको APIs & Services > Credentials पर वापस ले जाता है.

6. Credentials पेज पर, नीचे Service Accounts सेक्शन तक स्क्रोल करें और उस खाते के नाम पर क्लिक करें जिसे आपने अभी-अभी बनाया है.

7. Service account details पेज पर, नीचे Keys सेक्शन तक स्क्रोल करें और Add Key > Create new key चुनें.

8. कुंजी के टाइप के तौर पर JSON को चुनें और Create पर क्लिक करें. इससे एक JSON फ़ाइल डाउनलोड हो जाएगी, जिसमें आपकी मशीन की निजी कुंजी मौजूद होगी. डाउनलोड की गई JSON कुंजी फ़ाइल को किसी सुरक्षित जगह पर सेव करें.

   ध्यान दें: इस फ़ाइल में एक निजी कुंजी है, जिसे सार्वजनिक तौर पर सार्वजनिक नहीं किया जाना चाहिए. इसे GitHub जैसे पब्लिक सोर्स कोड के डेटा स्टोर करने की जगहों के लिए इस्तेमाल न करें.

OAuth2 टोकन जनरेट करें

arcore.management, Cloud anchors Management API के लिए OAuth स्कोप है. डिफ़ॉल्ट रूप से, oauth2l टोकन कैश मेमोरी पर काम करता है. fetch कमांड उसी टोकन को फिर से हासिल करता है. अनुमति देने के लिए, oauth2l का इस्तेमाल करके OAuth2 टोकन जनरेट करें:

oauth2l fetch --json creds.json arcore.management

नया टोकन जनरेट करने के लिए, fetch कमांड में --cache="" विकल्प जोड़ें.

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

आप चाहें, तो oauth2l reset को कॉल करें और fetch निर्देश को फिर से कॉल करें.

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

सभी क्लाउड ऐंकर की सूची बनाएं

क्लाउड ऐंकर का पहला पेज पाएं. हालांकि, इस पेज को expire_time, create_time या last_localize_time के हिसाब से क्रम में लगाया जा सकता है.

अनुरोध:

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"

जवाब:

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

अगर जवाब में भी nextPageToken दिखाई देता है, तो सूची में कुछ और ऐंकर विज्ञापन दिखाए जा सकते हैं. नतीजों का अगला सेट वापस पाने के लिए, अगले अनुरोध पर next_page_token क्वेरी पैरामीटर का इस्तेमाल करें.

अनुरोध:

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"

next_page_token का इस्तेमाल करते समय, page_size और order_by सभी अनुरोधों में एक जैसे होने चाहिए. page_size और 1000 की डिफ़ॉल्ट वैल्यू और order_by डिफ़ॉल्ट वैल्यू expire_time_desc होती है.

Cloud ऐंकर के लाइव स्ट्रीम का समय, तय की गई समयसीमा के हिसाब से अपडेट किया जा सकता है

किसी सिंगल क्लाउड ऐंकर का अनुरोध करें, ताकि इसके lastLocalizeTime और maximumExpireTime के बारे में क्वेरी की जा सके.

अनुरोध:

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"

जवाब:

{
  "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"
}

ऐंकर मिल जाने के बाद, इसके expireTime को इसके maximumExpireTime पर अपडेट करें.

अनुरोध:

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" }'

जवाब:

{
  "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"
}

क्लाउड ऐंकर मिटाएं

सिर्फ़ एक क्लाउड ऐंकर मिटाएं:

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"

क्लाउड ऐंकर का बैच मिटाएं:

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" ]}'