অংশীদার-নিয়ন্ত্রিত অ্যাকাউন্টগুলির বিধান - API বিকাশকারী গাইড৷

ভূমিকা

createAccountTree হল প্রভিশনিং API এর একটি অংশ যা স্কেলে নতুন Google Analytics অ্যাকাউন্ট তৈরি করতে ব্যবহার করা যেতে পারে। createAccountTicket এর বিপরীতে, createAccountTree অ্যাকাউন্ট তৈরি সম্পূর্ণ করার জন্য কোনো শেষ-ব্যবহারকারীর ইন্টারঅ্যাকশনের প্রয়োজন হয় না; প্রক্রিয়াটি সম্পূর্ণ স্বয়ংক্রিয়। এটি উপযোগী হয় যখন আপনাকে একটি অ্যানালিটিক্স অ্যাকাউন্টের ব্যবস্থা করতে হবে যা আপনি একজন গ্রাহকের হয়ে নিয়ন্ত্রণ করেন এবং যেখানে আপনি আপনার গ্রাহককে সেই ডেটার একটি কাস্টম ভিউ প্রদান করেন।

এই API অংশীদারদের জন্য সংরক্ষিত যারা তাদের ব্যবহারকারীদের ওয়েবসাইট বা ওয়েব বৈশিষ্ট্য নিয়ন্ত্রণ করে৷ যদি আপনার ব্যবহারকারীরা তাদের নিজস্ব ওয়েবসাইট বা ওয়েব প্রপার্টি নিয়ন্ত্রণ করে, তাহলে আপনার পরিবর্তে ব্যবহারকারী-নিয়ন্ত্রিত Analytics অ্যাকাউন্ট তৈরি করা উচিত।

তুমি শুরু করার আগে

সমস্ত Google Analytics API একই পদ্ধতিতে অ্যাক্সেস করা হয়। আপনি Provisioning API দিয়ে শুরু করার আগে আপনার উচিত:

  • API এর সাথে কাজ করে এমন প্রোগ্রামিং ভাষা নির্দিষ্ট ক্লায়েন্ট লাইব্রেরির একটি সম্পূর্ণ তালিকার জন্য ক্লায়েন্ট লাইব্রেরি পৃষ্ঠাটি পড়ুন।
  • API ইন্টারফেস এবং ক্লায়েন্ট লাইব্রেরি ছাড়াই কীভাবে ডেটা অ্যাক্সেস করা যায় সে সম্পর্কে জানতে রেফারেন্স গাইড পড়ুন।

প্রতিটি ক্লায়েন্ট লাইব্রেরি প্রোভিশনিং API অ্যাক্সেস করার জন্য একটি একক বিশ্লেষণ পরিষেবা অবজেক্ট প্রদান করে। পরিষেবা অবজেক্ট তৈরি করতে আপনাকে সাধারণত নিম্নলিখিত ধাপগুলি অতিক্রম করতে হবে:

  1. Google API কনসোলে আপনার অ্যাপ্লিকেশন নিবন্ধন করুন৷
  2. একটি নতুন Google Analytics অ্যাকাউন্ট তৈরি করতে অনুমোদন করুন৷
  3. একটি বিশ্লেষণ সেবা বস্তু তৈরি করুন.

আপনি যদি এই ধাপগুলি সম্পূর্ণ না করে থাকেন, তাহলে দয়া করে থামুন এবং Hello Google Analytics API টিউটোরিয়াল পড়ুন। এই টিউটোরিয়ালটি আপনাকে গুগল অ্যানালিটিক্স এপিআই অ্যাপ্লিকেশন তৈরির প্রাথমিক ধাপের মাধ্যমে নিয়ে যাবে। একবার সম্পূর্ণ হয়ে গেলে, আপনি বুঝতে পারবেন কিভাবে বাস্তব-বিশ্বের কাজগুলি সম্পাদন করতে Google Analytics API গুলি অ্যাক্সেস করতে হয়৷

টেমপ্লেট অ্যাকাউন্ট

এই API ব্যবহার করার জন্য অনুমোদিত হওয়ার অংশ হিসাবে, আপনাকে একটি নতুন Google Analytics অ্যাকাউন্ট প্রদান করতে হবে, যা এই API-এর টেমপ্লেট অ্যাকাউন্ট হিসাবে কাজ করে। যখন নতুন অ্যাকাউন্ট তৈরি করা হয়, তখন তারা টেমপ্লেট অ্যাকাউন্ট থেকে বিভিন্ন সেটিংস উত্তরাধিকারসূত্রে পায়, যার মধ্যে পরিষেবার শর্তাদি গ্রহণকারী, সংস্থা এবং বিভিন্ন ডেটা শেয়ারিং সেটিংস রয়েছে। সমস্ত উত্তরাধিকারসূত্রে পাওয়া ডেটার তালিকা সহ টেমপ্লেট অ্যাকাউন্ট সম্পর্কে আরও বিশদ বিবরণের জন্য createAccountTree রেফারেন্স দেখুন।

একটি অ্যাকাউন্টের ব্যবস্থা করা

একটি নতুন Google Analytics অ্যাকাউন্টের ব্যবস্থা করতে, createAccountTree API এন্ডপয়েন্টে একটি অনুরোধ করুন। আপনি নিম্নলিখিত বিধান বিবরণ প্রয়োজন হবে:

  • অ্যাকাউন্ট ক্ষেত্র
    • অ্যাকাউন্টের জন্য একটি accountName
  • ওয়েব সম্পত্তি ক্ষেত্র
    • সম্পত্তির জন্য একটি webpropertyName .
    • একটি websiteUrl । এই অ্যানালিটিক্স অ্যাকাউন্টের জন্য ব্যবহারকারীর সম্পত্তির সাথে যুক্ত URL হওয়া উচিত।
  • ক্ষেত্রগুলি দেখুন
    • দর্শনের জন্য একটি profileName
    • দেখার জন্য একটি timezone

একবার আপনার কাছে বিশদ বিবরণ আছে, API এন্ডপয়েন্টে একটি প্রমাণীকৃত কল করুন:

POST https://www.googleapis.com/analytics/v3/provisioning/createAccountTree
{
    "accountName": "Analytics Account",
    "webpropertyName": "Default Property",
    "profileName": "Default View",
    "timezone": "America/Los_Angeles",
    "websiteUrl": "www.example-pet-store.com",
}

সফল হলে, API নতুন তৈরি অ্যাকাউন্টের বিশদ বিবরণ সহ প্রতিক্রিয়া জানাবে, ওয়েব সম্পত্তি , এবং দেখুন :

{
    "account": {
        "id": "999999999",
        "name": "Analytics Account",
        "created": "2018-03-16T23:35:20.699Z",
        "updated": "2018-03-16T23:35:20.699Z",
        ...
    },
    "webproperty": {
        "id": "UA-999999999-1",
        "name": "Default Property",
        "websiteUrl": "www.example-pet-store.com",
        "created": "2018-03-16T23:35:20.699Z",
        "updated": "2018-03-16T23:35:20.699Z",
        ...
    },
    "profile": {
        "id": "999999999",
        "name": "Default View",
        "timezone": "America/Los_Angeles",
        "created": "2018-03-16T23:35:20.699Z",
        "updated": "2018-03-16T23:35:20.699Z",
        ...
    },
    ...
}

অ্যাকাউন্টের মালিকানা এবং ব্যবস্থাপনা

OAuth-এর মাধ্যমে প্রতিক্রিয়া অনুমোদিত যে কোনও ব্যবহারকারী অ্যাকাউন্টের মালিকানাধীন Google Analytics অ্যাকাউন্টের মালিকানা থাকবে। এই কারণে, আমরা সুপারিশ করি যে আপনার সংস্থা একটি পৃথক ব্যবহারকারী অ্যাকাউন্টের পরিবর্তে Analytics অ্যাকাউন্ট পরিচালনা করার জন্য একটি পরিষেবা অ্যাকাউন্ট ব্যবহার করে৷

অ্যাকাউন্ট তৈরি হওয়ার পরে, আপনি এটিকে ম্যানেজমেন্ট এপিআই দিয়ে কনফিগার করতে পারেন। এখানে একটি নতুন তৈরি অ্যাকাউন্টের জন্য কিছু সাধারণ কাজ রয়েছে:

অ্যাকাউন্ট সম্পর্ক স্পষ্টীকরণ

সমস্ত Google API-এর মতো, একটি Google ক্লাউড প্রকল্পের অনুরোধ অনুমোদনের জন্য একটি প্রারম্ভিক বিন্দু হিসাবে প্রয়োজন৷ OAuth 2.0 ডকুমেন্টেশনে বর্ণিত হিসাবে, এই অ্যাকাউন্টটি যেখানে আপনি API অনুরোধের জন্য আপনার শংসাপত্রগুলি পরিচালনা করবেন৷ যাইহোক, তৈরি করা Google Analytics অ্যাকাউন্ট ক্লাউড প্রজেক্ট বা এর পরিচালনা অ্যাকাউন্টগুলির সাথে সরাসরি কোনোভাবেই সংযুক্ত নয়; এটি শুধুমাত্র ব্যবহারকারী বা পরিষেবা অ্যাকাউন্টের সাথে অনুমোদিত যা অনুরোধটি অনুমোদন করেছে৷ আপনি যদি অ্যানালিটিক্স অ্যাকাউন্টে অ্যাকাউন্ট অ্যাক্সেস কনফিগার করতে চান তবে আপনি ম্যানেজমেন্ট API ব্যবহার করতে পারেন।