ম্যানিফেস্ট রেফারেন্স

ম্যানিফেস্ট ( appsscript.json ) হল আপনার Apps স্ক্রিপ্ট সংযোগকারী প্রকল্পের একটি JSON ফাইল। এতে আপনার কমিউনিটি কানেক্টর সম্পর্কে কিছু তথ্য রয়েছে যা লুকার স্টুডিওতে আপনার সংযোগকারী স্থাপন এবং ব্যবহার করার জন্য প্রয়োজন। অ্যাপস স্ক্রিপ্টে ম্যানিফেস্ট সম্পর্কে আরও পড়ুন।

আপনার ম্যানিফেস্টে নিম্নলিখিত তথ্য থাকা উচিত:

সম্পত্তির নাম টাইপ বর্ণনা
প্রয়োজনীয় ( dataStudio সম্পত্তির অধীনে)
name string আপনার সংযোগকারীর নাম।
28টি অক্ষরের মধ্যে সীমাবদ্ধ
company string প্রতিষ্ঠান বা বিকাশকারীর নাম।
companyUrl string (link) সংস্থা বা বিকাশকারীর ওয়েবসাইটের লিঙ্ক।
logoUrl string (image link) আপনার সংযোগকারীর জন্য একটি আইকনের URL।
প্রয়োজনীয় মাত্রা হল 40px x 40px।
addOnUrl string (link) একটি উত্সর্গীকৃত 'আরো জানুন' পৃষ্ঠার লিঙ্ক যা আপনার সংযোগকারী কী করে এবং এটি যে ডেটা অ্যাক্সেস করে তা ব্যাখ্যা করতে হবে৷ আপনি এই পৃষ্ঠা হোস্ট এবং বজায় রাখা উচিত.
এই পৃষ্ঠায় অবশ্যই আপনার পরিষেবার শর্তাবলী এবং গোপনীয়তা নীতির সাথে লিঙ্ক থাকতে হবে।
supportUrl string (link) এই সংযোগকারী সমর্থন করার জন্য সমর্থন পৃষ্ঠা লিঙ্ক. ব্যবহারকারীদের এই লিঙ্কে আপনার সংযোগকারীর সাথে সমস্যা রিপোর্ট করতে সক্ষম হওয়া উচিত। আপনি এই পৃষ্ঠা হোস্ট এবং বজায় রাখা উচিত.
description string আপনার সংযোগকারীর জন্য বিবরণ.
ব্যবহারকারীরা আপনার সংযোগকারী কনফিগারেশন পৃষ্ঠায় সম্পূর্ণ বিবরণ দেখতে পাবেন। লিঙ্ক ক্লিকযোগ্য হবে.
ঐচ্ছিক ( dataStudio সম্পত্তির অধীনে)
shortDescription string সীমা: 114 অক্ষর। আপনার সংযোগকারী প্রকাশিত হলে, এই সংক্ষিপ্ত বিবরণটি আপনার সংযোগকারীর গ্যালারি কার্ডে দৃশ্যমান হবে৷ আপনার সংযোগকারী কি করে তা সংক্ষেপে বর্ণনা করতে এটি ব্যবহার করুন। ব্যবহারকারীরা গ্যালারিতে সংযোগকারীর মাধ্যমে ব্রাউজ করার সময় এটি দেখতে সক্ষম হবে।
privacyPolicyUrl string (link) সংযোগকারী / বিকাশকারী সংস্থার গোপনীয়তা নীতির লিঙ্ক।
termsOfServiceUrl string (link) সংযোগকারী / বিকাশকারী সংস্থার পরিষেবার শর্তাবলীর লিঙ্ক৷
authType list( AuthType ) আপনার সংযোগকারীর জন্য প্রমাণীকরণ পদ্ধতির ধরন। নিচে AuthType দেখুন।
feeType list( FeeType ) আপনার সংযোগকারীর জন্য ফি প্রকার নির্দেশ করে৷ নিচে ফি টাইপ দেখুন।
sources list( Sources ) এই সংযোগকারীর সাথে সংযোগ করতে পারে এমন ডেটা উত্সগুলির তালিকা৷ নীচের উত্স দেখুন.
templates Object এই সংযোগকারীর সাথে ব্যবহার করা যেতে পারে এমন টেমপ্লেটগুলির তালিকা৷ শুধুমাত্র একটি ডিফল্ট টেমপ্লেট সমর্থিত, একটি default কী সেট করে চিহ্নিত করা হয়। মানটি লুকার স্টুডিও রিপোর্টের রিপোর্ট আইডি হওয়া উচিত যা টেমপ্লেট হিসাবে ব্যবহার করা হবে। রিপোর্ট টেমপ্লেট প্রদানের নির্দেশিকা দেখুন।
forceViewersCredentials boolean এই সংযোগকারী থেকে তৈরি ডেটা উত্সগুলির জন্য দর্শকের শংসাপত্রগুলি বাধ্য করা উচিত কিনা৷ এই সম্পত্তি ঐচ্ছিক এবং false থেকে ডিফল্ট। দর্শকের শংসাপত্র সম্পর্কে আরও বিশদ বিবরণের জন্য ডেটা উত্স শংসাপত্রগুলি দেখুন৷
useQueryConfig boolean অপ্রচলিত : এই সংযোগকারীটি `getData()` এর জন্য একটি ক্যোয়ারী কনফিগারেশন ফিরিয়ে দেবে কিনা। পরিবর্তে `উন্নত সেবা` ব্যবহার করুন।
advancedServices.data boolean এই সংযোগকারী `getData()`-এর জন্য একটি ক্যোয়ারী কনফিগারেশন ফিরিয়ে দেবে কি না। উন্নত পরিষেবা দেখুন।
advancedServices.schema boolean এই সংযোগকারী `getSchema()`-এর জন্য একটি ক্যোয়ারী কনফিগারেশন ফিরিয়ে দেবে কি না। উন্নত পরিষেবা দেখুন।
ঐচ্ছিক (রুট স্তরের সম্পত্তি)
urlFetchWhitelist list(string) HTTPS URL উপসর্গের একটি তালিকা যা আপনার সংযোগকারী ব্যবহার করে। যেকোনও ইউআরএল এন্ডপয়েন্ট আনতে হবে এই তালিকার একটি উপসর্গের সাথে মেলে। এটি ব্যবহারকারীর ডেটা রক্ষা করতে সাহায্য করতে পারে। আরও বিশদ বিবরণের জন্য নিরাপদ তালিকাভুক্ত URL দেখুন।

AuthType

প্রমাণীকরণ পদ্ধতি প্রকারের মানগুলি নিম্নলিখিতগুলির মধ্যে একটি হতে পারে:

এনাম মান বর্ণনা
NONE নির্দেশ করে যে সংযোগকারীর জন্য কোন প্রমাণীকরণের প্রয়োজন নেই।
OAUTH2 ইঙ্গিত করে যে সংযোগকারীটি OAuth 2.0 ব্যবহার করে৷
KEY সংযোগকারী API কী ব্যবহার করে নির্দেশ করে।
USER_PASS সংযোগকারী ব্যবহারকারীর নাম/পাসওয়ার্ড ব্যবহার করে নির্দেশ করে।
USER_TOKEN সংযোগকারী ব্যবহারকারীর নাম/টোকেন ব্যবহার করে নির্দেশ করে।
PATH_USER_PASS সংযোগকারী পথ/ব্যবহারকারীর নাম/পাসওয়ার্ড ব্যবহার করে নির্দেশ করে।
PATH_KEY সংযোগকারী পাথ/কী ব্যবহার করে নির্দেশ করে।

ফি টাইপ

ফি টাইপের মান নিম্নলিখিত যেকোনও হতে পারে:

এনাম মান বর্ণনা
FREE ইঙ্গিত করে যে সংযোগকারীটি ব্যবহারের জন্য সম্পূর্ণ বিনামূল্যে।
FREE_TRIAL সংযোগকারীর একটি বিনামূল্যে ট্রায়াল বিকল্প আছে নির্দেশ করে।
PAID ব্যবহারকারীকে সংযোগকারী ব্যবহার করার জন্য অর্থ প্রদান করতে হবে নির্দেশ করে।

সূত্র

উৎস হল উৎসের জন্য enums এর একটি তালিকা। আপনি আমাদের ডেটা রেজিস্ট্রি রিপোজিটরিতে উত্সগুলির বিদ্যমান তালিকা দেখতে পারেন৷ আপনি যে উৎসের সাথে সংযোগ করছেন সেটি সংগ্রহস্থলে বিদ্যমান না থাকলে, উৎস যোগ করার জন্য ডেটা রেজিস্ট্রি সংগ্রহস্থলে একটি টান অনুরোধ পাঠান। উৎসের নামটিতে শুধুমাত্র বড় হাতের অক্ষর এবং আন্ডারস্কোর থাকতে পারে (যেমন Google Analytics হবে GOOGLE_ANALYTICS )। আপনার কমিউনিটি কানেক্টর ম্যানিফেস্টে, ডেটা সোর্স আইডি প্রপার্টির মান ব্যবহার করুন, যেমন GOOGLE_ANALYTICS

একটি সম্প্রদায় সংযোগকারীর জন্য উদাহরণ ম্যানিফেস্ট৷

নিম্নলিখিত একটি সম্পূর্ণ ম্যানিফেস্টের একটি উদাহরণ:

data-studio/appsscript.json
{
  "dataStudio": {
    "name": "Nucleus by Hooli",
    "company": "Hooli Inc.",
    "companyUrl": "https://hooli.xyz",
    "logoUrl": "https://hooli.xyz/middle-out-optimized/nucleus/logo.png",
    "addonUrl": "https://hooli.xyz/data-studio-connector",
    "supportUrl": "https://hooli.xyz/data-studio-connector/support",
    "description": "Nucleus by Hooli connector lets you connect to your data in Data Studio using Nucleus middle out optimization. You will need an account on hooli.xyz to use this connector. Create your account at https://hooli.xyz/signup",
    "shortDescription": "Connect to your data using Nucleus middle out optimization",
    "privacyPolicyUrl": "https://hooli.xyz/privacy",
    "termsOfServiceUrl": "https://hooli.xyz/tos",
    "authType": ["NONE"],
    "feeType": ["PAID"],
    "sources": ["HOOLI_CHAT_LOG", "ENDFRAME_SERVER_STREAM", "RETINABYTE_USER_ANALYTICS"],
    "templates": {
      "default": "872223s89f5fdkjnd983kjf"
    }
  },
  "urlFetchWhitelist": [
    "https://api.hooli.xyz/",
    "https://hooli.xyz/"
  ]
}