স্কেলে অবস্থানগুলি পরিচালনা করুন

আপনার প্রতিষ্ঠান বড় হওয়ার সাথে সাথে, বিভিন্ন অবস্থান ও অনুমতির ব্যবস্থাপনা আপনার জন্য কঠিন হয়ে উঠতে পারে। এই নির্দেশিকায় একাধিক অবস্থান পরিচালনার সর্বোত্তম পদ্ধতিগুলো বিস্তারিতভাবে বর্ণনা করা হয়েছে এবং নিম্নলিখিত অ্যাকাউন্ট প্রকারগুলো সম্পর্কে বলা হয়েছে:

• ব্যক্তিগত অ্যাকাউন্ট
• সংস্থার অ্যাকাউন্ট
• অবস্থান গ্রুপ অ্যাকাউন্ট
• ব্যবহারকারী গোষ্ঠীর অ্যাকাউন্ট

অ্যাকাউন্টের প্রকারভেদ

অবস্থান ব্যবস্থাপনার ক্ষেত্রে প্রতিটি অ্যাকাউন্ট ধরনের একটি ভূমিকা থাকে। একটি ব্যক্তিগত অ্যাকাউন্ট একটি প্রাতিষ্ঠানিক অ্যাকাউন্ট পরিচালনা করতে পারে এবং তারপর সেই প্রতিষ্ঠানের ব্যবহারকারী গোষ্ঠী ও অবস্থান গোষ্ঠীগুলিতে অনুমতি লাভ করতে পারে। এরপর ব্যক্তিগত অ্যাকাউন্টটি সংশ্লিষ্ট অবস্থান গোষ্ঠীগুলির মাধ্যমে অবস্থান এবং তালিকা পরিচালনা করতে পারে।

ব্যক্তিগত অ্যাকাউন্ট

আপনি যখন একটি গুগল অ্যাকাউন্ট তৈরি করেন, তখন স্বয়ংক্রিয়ভাবে আপনার জন্য একটি ব্যক্তিগত অ্যাকাউন্ট উপলব্ধ হয়ে যায়। ব্যক্তিগত অ্যাকাউন্টধারীরা লিস্টিংয়ের মালিক এবং ব্যবস্থাপক হতে পারেন।

সংস্থার অ্যাকাউন্ট

একটি সংস্থা অ্যাকাউন্ট হলো সেই মূল অ্যাকাউন্ট যা আপনার এজেন্সিকে প্রতিনিধিত্ব করে। আপনার অবস্থান গোষ্ঠী এবং ব্যবহারকারী গোষ্ঠীগুলি এতে সংরক্ষিত থাকে এবং একটি সংস্থার সকল সদস্যের সেগুলিতে প্রবেশাধিকার থাকে। অবস্থানগুলি একাধিক সংস্থার অংশ হতে পারে।

My Business Account Management API-এর মাধ্যমে, আপনি accounts.admins.create মেথড ব্যবহার করে ব্যক্তিগত অ্যাকাউন্টগুলোকে অর্গানাইজেশন অ্যাকাউন্ট পরিচালনা বা মালিকানা গ্রহণের জন্য আমন্ত্রণ জানাতে পারেন।

অবস্থান গ্রুপ অ্যাকাউন্ট

একটি লোকেশন গ্রুপ একাধিক স্বতন্ত্র লোকেশন পরিচালনা করতে ব্যবহৃত হয়। আপনি একাধিক লোকেশনে একসাথে অনেক কাজ সম্পাদন করার জন্য একটি লোকেশন গ্রুপ ব্যবহার করতে পারেন। যখন আপনি একটি লোকেশন গ্রুপে ব্যক্তিগত অ্যাকাউন্ট এবং ইউজার গ্রুপ যোগ করেন, তখন তারা সেই লোকেশন গ্রুপের অনুমতিগুলো লাভ করে।

আপনি লোকেশনগুলোকে বিভিন্ন ভাগে ভাগ করার জন্য লোকেশন গ্রুপও তৈরি করতে পারেন, যেমন—চেইন, অঞ্চল বা ক্যাটাগরি অনুযায়ী। একটি লোকেশন একই সাথে একাধিক লোকেশন গ্রুপের অন্তর্ভুক্ত হতে পারে।

দ্রষ্টব্য: কোনো সংস্থা বা ব্যবহারকারী গোষ্ঠীর অন্তর্ভুক্ত ব্যক্তিগত অ্যাকাউন্ট সরাসরি কোনো অবস্থান বা অবস্থান গোষ্ঠীর মালিক হওয়ার যোগ্য নয়।

My Business Account Management API-এর মাধ্যমে, আপনি accounts.create মেথড ব্যবহার করে লোকেশন গ্রুপ তৈরি করতে এবং কোনো লোকেশন গ্রুপে লোকেশন স্থানান্তর করতে পারেন । এছাড়াও, এই API ব্যবহার করে আপনি ব্যক্তিগত অ্যাকাউন্টগুলোকে লোকেশন গ্রুপ পরিচালনা করার জন্য আমন্ত্রণ জানাতে পারেন। ওয়েব ইন্টারফেস থেকে সরাসরি ইউজার গ্রুপগুলোকে লোকেশন গ্রুপে যুক্ত করা যায়।

ব্যবহারকারী গোষ্ঠীর অ্যাকাউন্ট

বৃহৎ পরিসরে অনুমতি ব্যবস্থাপনার জন্য একটি ইউজার গ্রুপ ব্যবহার করুন। আপনি একটি ইউজার গ্রুপে ব্যক্তিগত অ্যাকাউন্ট যুক্ত করতে পারেন। এরপর, আপনি সেই ইউজার গ্রুপকে প্রতিষ্ঠানের একাধিক লোকেশন গ্রুপে ম্যানেজমেন্ট অ্যাক্সেস দিতে পারেন। এখন ইউজার গ্রুপের সমস্ত ব্যক্তিগত অ্যাকাউন্ট লোকেশন গ্রুপগুলোর অধীনে থাকা লোকেশনগুলোতে ব্যবস্থাপকীয় কাজ সম্পাদন করতে পারবে।

দ্রষ্টব্য: কোনো লোকেশন গ্রুপে ব্যক্তিগত অ্যাকাউন্ট যোগ না করাই শ্রেয়। এর পরিবর্তে, সরাসরি ইউজার গ্রুপগুলোকে অ্যাক্সেস দিন। বৃহৎ পরিসরে ব্যবস্থাপনার জন্য এটি একটি সহজতর উপায়।

উদাহরণস্বরূপ, যখন কোনো নতুন সদস্য একটি অপারেশনস টিমে যোগ দেন, আপনি তাকে সরাসরি একটি ইউজার গ্রুপে যুক্ত করতে পারেন এবং তিনি সঙ্গে সঙ্গেই সেই সমস্ত লোকেশনে অ্যাক্সেস পেয়ে যান যেখানে তার সহকর্মীরা অ্যাক্সেস করতে পারে। ব্যবহারকারীদের প্রতিটি আলাদা লোকেশনে অ্যাক্সেস দিতে বেশি সময় লাগে এবং সেইভাবে এটি পরিচালনা করাও আরও কঠিন।

My Business Account Management API-এর মাধ্যমে, আপনি accounts.create মেথড ব্যবহার করে ইউজার গ্রুপ তৈরি করতে পারেন। এছাড়াও, অ্যাকাউন্ট এবং লোকেশনের অ্যাডমিনদের ম্যানেজ করার জন্য ব্যক্তিগত অ্যাকাউন্টগুলোকে আমন্ত্রণ জানাতেও আপনি এই API ব্যবহার করতে পারেন।

সমস্ত অ্যাকাউন্টের তালিকা পেতে এপিআই ব্যবহার করুন।

আপনার অ্যাক্সেস আছে এমন সমস্ত অ্যাকাউন্ট এবং তাদের সংশ্লিষ্ট অ্যাকাউন্টের ধরন তালিকাভুক্ত করতে, আপনার OAuth ক্রেডেনশিয়াল সহ accounts.list মেথডটি কল করুন। রেসপন্সে সমস্ত অ্যাকাউন্টের একটি তালিকা, তাদের অ্যাকাউন্ট আইডি (যা name ফিল্ডে থাকে) এবং অ্যাকাউন্টের ধরনগুলো উল্লেখ থাকে।

অনুরোধ

নিম্নলিখিতটি একটি accounts.list অনুরোধের উদাহরণ:

HTTP

GET
https://mybusinessaccountmanagement.googleapis.com/v1/accounts
Authorization: Bearer <access_token>

প্রতিক্রিয়া

নিম্নলিখিতটি accounts.list প্রতিক্রিয়ার একটি উদাহরণ:

{
    "accounts": [
        {
            "name": "accounts/{accountId}",
            "accountName": "John Doe",
            "type": "PERSONAL",
            "state": {
                "status": "UNVERIFIED"
            },
            "profilePhotoUrl": "//lh5.googleusercontent.com/REDACTED"
        },
        {
            "name": "accounts/{accountId}",
            "accountName": "John Doe’s Location Group",
            "type": "LOCATION_GROUP",
            "role": "OWNER",
            "state": {
                "status": "UNVERIFIED"
            },
            "accountNumber": "{accountNumber}",
            "permissionLevel": "OWNER_LEVEL"
        }
    ]
}

এই নির্দেশিকায় বিস্তারিতভাবে বর্ণিত সমস্ত অ্যাকাউন্টের ধরন আপনার accounts.list অনুরোধের প্রতিক্রিয়ায় অন্তর্ভুক্ত থাকতে পারে। অ্যাকাউন্টের তালিকাটি পর্যালোচনা করুন এবং সেই নির্দিষ্ট অ্যাকাউন্টটি শনাক্ত করুন যেটির কাছে আপনি পরিচালনা করতে চান এমন অবস্থানগুলিতে অ্যাক্সেস আছে। তারপর, সেই নির্দিষ্ট অ্যাকাউন্টের name ফিল্ড ব্যবহার করে accounts.locations.list কল করুন, যাতে সেই অ্যাকাউন্টের অ্যাক্সেস আছে এমন অবস্থানগুলির একটি তালিকা পাওয়া যায়।

উদাহরণস্বরূপ, আপনি যদি 'জন ডো-এর লোকেশন গ্রুপ'-এর অন্তর্গত সমস্ত লোকেশন পুনরুদ্ধার করতে চান, তাহলে নিম্নলিখিত অনুরোধটি করুন:

HTTP

GET
https://mybusinessbusinessinformation.googleapis.com/v1/{accountId}/locations
Authorization: Bearer <access_token>

প্রতিক্রিয়াটি ব্যবহারকারীর অ্যাক্সেস আছে এমন অবস্থানগুলির একটি তালিকা ফেরত দেয়, যা নিম্নরূপ:

{
    "locations": [
        {
            "name": "locations/{locationId}",
            "locationName": "Test Business",
            ...
        },
        {
            "name": "locations/{locationId}",
            "locationName": "2nd Test Business",
            ...
         }
     ]
}

অবস্থান ব্যবস্থাপনা ডায়াগ্রাম

নিম্নলিখিত চিত্রটি নিম্নলিখিত বিষয়গুলি তুলে ধরে:

• একটি প্রতিষ্ঠানে একাধিক ব্যবহারকারী গোষ্ঠী থাকতে পারে।
• ব্যবহারকারী গোষ্ঠী একাধিক অবস্থান গোষ্ঠী পরিচালনা করতে পারে।
• অবস্থান গ্রুপে একাধিক অবস্থান থাকতে পারে।
• প্রতিষ্ঠানের বিভিন্ন স্থানে একাধিক অবস্থান গোষ্ঠী থাকতে পারে।

চিত্র ১. অবস্থান ব্যবস্থাপনার স্তরবিন্যাস