ক্রোম ওয়েব স্টোর API রেফারেন্স

এই রেফারেন্সটি Chrome ওয়েব স্টোর পাবলিশ API-এর জন্য উপলব্ধ পদ্ধতি এবং সংস্থান উপস্থাপনা বর্ণনা করে। প্রতিটি সংস্থান প্রকারের এক বা একাধিক ডেটা উপস্থাপনা এবং এক বা একাধিক পদ্ধতি রয়েছে। বাস্তবায়নের বিশদ বিবরণের জন্য Chrome ওয়েব স্টোর পাবলিশ API ব্যবহার করা দেখুন।

আইটেম

আইটেম সম্পদ বিবরণের জন্য, সম্পদ উপস্থাপনা দেখুন। ইউআরআইগুলি https://www.googleapis.com-এর সাথে সম্পর্কিত, যদি না অন্যথায় উল্লেখ করা হয়

অপারেশন HTTP অনুরোধ বর্ণনা
পাওয়া পাওয়া
/chromewebstore/v1.1/items/ itemId		 একটি Chrome ওয়েব স্টোর আইটেম পায়৷ URL-এ projection="DRAFT" প্রদান করুন (কেস সংবেদনশীল)।
সন্নিবেশ পোস্ট
/upload/chromewebstore/v1.1/items		 একটি নতুন আইটেম সন্নিবেশ করান।
প্রকাশ পোস্ট
/chromewebstore/v1.1/
items/ itemId /publish		 একটি আইটেম প্রকাশ করে।

ঐচ্ছিক publishTarget ক্যোয়ারী প্যারামিটার নির্দিষ্ট করে কিভাবে আইটেম প্রকাশ করা হবে। বৈধ মান হল "trustedTesters" এবং "default" ।
হালনাগাদ PUT
/upload/chromewebstore/v1.1/
items/ itemId

এবং

PUT
/items/ itemId		 একটি বিদ্যমান আইটেম আপডেট করে।

সম্পদ প্রতিনিধিত্ব

{
  "kind": "chromewebstore#item",
  "id": string,
  "publicKey": string,
  "uploadState": string,
  "itemError": [
    (value)
  ]
}
সম্পত্তির নাম মান বর্ণনা
id স্ট্রিং আইটেমের অনন্য আইডি।
itemError[] তালিকা অপারেশনের বিশদ মানব-পাঠযোগ্য অবস্থা, শুধুমাত্র ইংরেজিতে। আপনি যখন Chrome ওয়েব স্টোরে আপনার অ্যাপ আপলোড করেন তখন একই ত্রুটি বার্তাগুলি প্রদর্শিত হয়৷
kind স্ট্রিং এই সম্পদটিকে একটি আইটেম হিসাবে চিহ্নিত করে। মান: স্থির স্ট্রিং "chromewebstore#item" ।
publicKey স্ট্রিং এই আইটেমটির সর্বজনীন কী।
uploadState স্ট্রিং অপারেশনের অবস্থা।

গ্রহণযোগ্য মান হল:
  • " FAILURE "
  • " IN_PROGRESS "
  • " NOT_FOUND "
  • " SUCCESS "

পাওয়া

একটি Chrome ওয়েব স্টোর আইটেম পায়৷ একটি URL প্যারামিটার হিসাবে projection="DRAFT" (কেস সংবেদনশীল) প্রদান করুন।

অনুরোধ

HTTP অনুরোধ

GET https://www.googleapis.com/chromewebstore/v1.1/items/itemId

পরামিতি

পরামিতি নাম মান বর্ণনা
পাথ প্যারামিটার
itemId স্ট্রিং ক্রোম অ্যাপ, ক্রোম এক্সটেনশন বা ক্রোম থিম প্রতিনিধিত্বকারী অনন্য শনাক্তকারী৷
ঐচ্ছিক ক্যোয়ারী পরামিতি
projection স্ট্রিং আইটেম তথ্যের কোন উপসেট ফেরত দিতে হবে তা নির্ধারণ করে।

গ্রহণযোগ্য মান হল:
  • " DRAFT ": বর্তমান খসড়া থেকে আহরিত তথ্য ফেরত দিন।
  • " PUBLISHED ": প্রকাশিত আইটেমের খসড়া থেকে নেওয়া তথ্য ফেরত দিন।
মনে রাখবেন যে এই সময়ে শুধুমাত্র "DRAFT" সমর্থিত।

অনুমোদন

এই অনুরোধ নিম্নলিখিত সুযোগ সঙ্গে অনুমোদন প্রয়োজন.

https://www.googleapis.com/auth/chromewebstore.readonly

একটি অ্যাক্সেস টোকেন তৈরি করার সময় উপরের URLটি স্কোপ প্যারামিটার হিসাবে ব্যবহৃত হয়। API অনুমোদন এবং প্রমাণীকরণ সম্পর্কে আরও বিশদের জন্য, OAuth 2.0 ডকুমেন্টেশন দেখুন।

শরীরের অনুরোধ

এই পদ্ধতির সাথে একটি অনুরোধ সংস্থা সরবরাহ করবেন না।

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

সফল হলে, এই পদ্ধতিটি প্রতিক্রিয়া বডিতে একটি আইটেম সম্পদ প্রদান করে।

ঢোকান

একটি নতুন আইটেম সন্নিবেশ করান.

এই পদ্ধতিটি একটি আপলোড ইউআরআই সমর্থন করে এবং আপলোড করা মিডিয়া গ্রহণ করে।

অনুরোধ

HTTP অনুরোধ

POST https://www.googleapis.com/upload/chromewebstore/v1.1/items

পরামিতি

পরামিতি নাম মান বর্ণনা
প্রয়োজনীয় ক্যোয়ারী প্যারামিটার
uploadType স্ট্রিং /আপলোড URI-তে আপলোডের অনুরোধের ধরন। একমাত্র গৃহীত মান হল media : মিডিয়া ডেটার একটি সাধারণ আপলোড৷
ঐচ্ছিক ক্যোয়ারী পরামিতি
publisherEmail স্ট্রিং আইটেমগুলির মালিক প্রকাশকের ইমেল৷ কলারের ইমেল ঠিকানায় ডিফল্ট।

অনুমোদন

এই অনুরোধ নিম্নলিখিত সুযোগ সঙ্গে অনুমোদন প্রয়োজন.

https://www.googleapis.com/auth/chromewebstore

একটি অ্যাক্সেস টোকেন তৈরি করার সময় উপরের URLটি স্কোপ প্যারামিটার হিসাবে ব্যবহৃত হয়। API অনুমোদন এবং প্রমাণীকরণ সম্পর্কে আরও বিশদের জন্য, OAuth 2.0 ডকুমেন্টেশন দেখুন।

শরীরের অনুরোধ

এই পদ্ধতির সাথে একটি অনুরোধ সংস্থা সরবরাহ করবেন না।

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

সফল হলে, এই পদ্ধতিটি প্রতিক্রিয়া বডিতে একটি আইটেম সম্পদ প্রদান করে।

প্রকাশ করুন

একটি আইটেম প্রকাশ করে। URL এ সংজ্ঞায়িত publishTarget প্রদান করুন (কেস সংবেদনশীল): publishTarget = "trustedTesters" বা publishTarget = "default"।

অনুরোধ

HTTP অনুরোধ

POST https://www.googleapis.com/chromewebstore/v1.1/items/itemId/publish

পরামিতি

পরামিতি নাম মান বর্ণনা
পাথ প্যারামিটার
itemId স্ট্রিং আইটেমের আইডি প্রকাশ করতে হবে।
ঐচ্ছিক ক্যোয়ারী পরামিতি
publishTarget স্ট্রিং URL এ সংজ্ঞায়িত publishTarget প্রদান করুন (কেস সংবেদনশীল): publishTarget="trustedTesters" বা publishTarget="default" । publishTarget="default" থেকে ডিফল্ট।

শরীরের অনুরোধ

অনুরোধের অংশে, আপনি ঐচ্ছিকভাবে নিম্নলিখিত কাঠামোর সাথে ডেটা সরবরাহ করতে পারেন:

JSON

{
  "target": string
}
সম্পত্তির নাম মান বর্ণনা
target string এই প্রকাশনা অপারেশন লক্ষ্য প্রকাশ. এটি একটি URL ক্যোয়ারী প্যারামিটার হিসাবে publishTarget ব্যবহার করার মতই। স্ট্রিং মান হয় target="trustedTesters" বা target="default" হতে পারে। ডিফল্ট মান, যদি কোনোটি সরবরাহ করা না হয়, তা হল target="default"। প্রস্তাবিত ব্যবহার হল মান নির্দিষ্ট করতে URL ক্যোয়ারী প্যারামিটার ব্যবহার করা।

অনুমোদন

এই অনুরোধ নিম্নলিখিত সুযোগ সঙ্গে অনুমোদন প্রয়োজন.

https://www.googleapis.com/auth/chromewebstore

একটি অ্যাক্সেস টোকেন তৈরি করার সময় উপরের URLটি স্কোপ প্যারামিটার হিসাবে ব্যবহৃত হয়। API অনুমোদন এবং প্রমাণীকরণ সম্পর্কে আরও বিশদের জন্য, OAuth 2.0 ডকুমেন্টেশন দেখুন।

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

সফল হলে, এই পদ্ধতিটি নিম্নলিখিত কাঠামো সহ একটি প্রতিক্রিয়া বডি প্রদান করে:

{
  "kind": "chromewebstore#item",
  "item_id": string,
  "status": [
    string
  ],
  "statusDetail": [
    string
  ]
}
সম্পত্তির নাম মান বর্ণনা
kind string স্ট্যাটিক স্ট্রিং মান সর্বদা "chromewebstore#item" ।
item_id string এই আইটেম আইডি.
status[] list এই প্রকাশ অপারেশনের অবস্থা কোড. এটিতে নিম্নলিখিত তালিকা থেকে একাধিক উপাদান থাকতে পারে: OK , NOT_AUTHORIZED PUBLISHER_SUSPENDED INVALID_DEVELOPER , DEVELOPER_NO_OWNERSHIP , DEVELOPER_SUSPENDED , ITEM_NOT_FOUND , ITEM_PENDING_REVIEW , ITEM_TAKEN_DOWN
statusDetail[] list উপরে স্ট্যাটাস কোডের বিশদ মানব-বোধগম্য ব্যাখ্যা।

হালনাগাদ

একটি বিদ্যমান আইটেম আপডেট করে।

এই পদ্ধতিটি একটি আপলোড ইউআরআই সমর্থন করে এবং আপলোড করা মিডিয়া গ্রহণ করে।

অনুরোধ

HTTP অনুরোধ

এই পদ্ধতি দুটি পৃথক URI-এর মাধ্যমে মিডিয়া আপলোড কার্যকারিতা প্রদান করে।

  • মিডিয়া আপলোড অনুরোধের জন্য URI আপলোড করুন:

    PUT https://www.googleapis.com/upload/chromewebstore/v1.1/items/itemId

  • মেটাডেটা URI, শুধুমাত্র মেটাডেটা অনুরোধের জন্য:

    PUT https://www.googleapis.com/chromewebstore/v1.1/items/itemId

পরামিতি

পরামিতি নাম মান বর্ণনা
পাথ প্যারামিটার
itemId string আপলোড করার জন্য আইটেমটির আইডি।
প্রয়োজনীয় ক্যোয়ারী প্যারামিটার
uploadType string /আপলোড URI-তে আপলোডের অনুরোধের ধরন। গ্রহণযোগ্য মান হল: media - সহজ আপলোড। কোনো মেটাডেটা ছাড়া শুধুমাত্র মিডিয়া আপলোড করুন.

শরীরের অনুরোধ

অনুরোধের অংশে, মেটাডেটা হিসাবে একটি আইটেম সংস্থান সরবরাহ করুন।

অনুমোদন

এই অনুরোধ নিম্নলিখিত সুযোগ সঙ্গে অনুমোদন প্রয়োজন.

https://www.googleapis.com/auth/chromewebstore

একটি অ্যাক্সেস টোকেন তৈরি করার সময় উপরের URLটি স্কোপ প্যারামিটার হিসাবে ব্যবহৃত হয়। API অনুমোদন এবং প্রমাণীকরণ সম্পর্কে আরও বিশদের জন্য, OAuth 2.0 ডকুমেন্টেশন দেখুন।

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

সফল হলে, এই পদ্ধতিটি প্রতিক্রিয়া বডিতে একটি আইটেম সম্পদ প্রদান করে।