ARCore ক্লাউড অ্যাঙ্কর ম্যানেজমেন্ট API

ARCore ক্লাউড অ্যাঙ্কর ম্যানেজমেন্ট API ব্যবহার করে আপনার ARCore অ্যাপের বাইরে ক্লাউড অ্যাঙ্কর পরিচালনা করুন।

শুরু হচ্ছে

উদাহরণ অপারেশন

অনুমোদন

Google ক্লাউড প্ল্যাটফর্ম কনসোলে একটি পরিষেবা অ্যাকাউন্ট কী তৈরি করুন এবং ক্লাউড অ্যাঙ্কর পরিচালনা API কলগুলিকে অনুমোদন করতে একটি OAuth2 টোকেন তৈরি করুন৷

  1. Google ক্লাউড প্ল্যাটফর্ম কনসোলের নেভিগেশন মেনুতে, 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 কী ফাইলটি একটি নিরাপদ স্থানে সংরক্ষণ করুন।

একটি 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

সমস্ত ক্লাউড অ্যাঙ্কর তালিকাভুক্ত করুন

ক্লাউড অ্যাঙ্করগুলির প্রথম পৃষ্ঠা পান, ঐচ্ছিকভাবে 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 .

সর্বাধিক অনুমোদিত সময় বেঁচে থাকার জন্য একটি ক্লাউড অ্যাঙ্করের সময় আপডেট করুন৷

একটি একক ক্লাউড অ্যাঙ্করকে তার 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" ]}'
,

ARCore ক্লাউড অ্যাঙ্কর ম্যানেজমেন্ট API ব্যবহার করে আপনার ARCore অ্যাপের বাইরে ক্লাউড অ্যাঙ্কর পরিচালনা করুন।

শুরু হচ্ছে

উদাহরণ অপারেশন

অনুমোদন

Google ক্লাউড প্ল্যাটফর্ম কনসোলে একটি পরিষেবা অ্যাকাউন্ট কী তৈরি করুন এবং ক্লাউড অ্যাঙ্কর পরিচালনা API কলগুলিকে অনুমোদন করতে একটি OAuth2 টোকেন তৈরি করুন৷

  1. Google ক্লাউড প্ল্যাটফর্ম কনসোলের নেভিগেশন মেনুতে, 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 কী ফাইলটি একটি নিরাপদ স্থানে সংরক্ষণ করুন।

একটি 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

সমস্ত ক্লাউড অ্যাঙ্কর তালিকাভুক্ত করুন

ক্লাউড অ্যাঙ্করগুলির প্রথম পৃষ্ঠা পান, ঐচ্ছিকভাবে 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 .

সর্বাধিক অনুমোদিত সময় বেঁচে থাকার জন্য একটি ক্লাউড অ্যাঙ্করের সময় আপডেট করুন৷

একটি একক ক্লাউড অ্যাঙ্করকে তার 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" ]}'