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

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

शुरू करना

• अनुमति देना
• 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 निर्देश उसी जानकारी को वापस लाता है टोकन. OAuth2 जनरेट करने के लिए, oauth2l का इस्तेमाल करें अनुमति देने के लिए टोकन:

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

सभी Cloud ऐंकर की सूची बनाएं

Cloud Anchors का पहला पेज पाएं. इसे 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 anchor के समय को ज़्यादा से ज़्यादा समय तक बनाए रखने के लिए अपडेट करें

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"

Cloud ऐंकर का बैच मिटाएं:

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