Users.sessions: list

পূর্বে তৈরি সেশন তালিকা. এখনই চেষ্টা করে দেখুন

অনুরোধ

HTTP অনুরোধ

GET https://www.googleapis.com/fitness/v1/users/userId/sessions

পরামিতি

পরামিতি নাম মান বর্ণনা
পাথ প্যারামিটার
userId string চিহ্নিত ব্যক্তির জন্য তালিকা সেশন. প্রমাণীকৃত ব্যবহারকারী নির্দেশ করতে me ব্যবহার করুন। এই সময়ে শুধুমাত্র me সমর্থিত.
ঐচ্ছিক ক্যোয়ারী পরামিতি
activityType integer খালি না থাকলে, শুধুমাত্র এই ধরনের কার্যকলাপের সাথে সেশনগুলি ফেরত দেওয়া উচিত।
endTime string একটি RFC3339 টাইমস্ট্যাম্প। শুধুমাত্র শুরু এবং শেষ সময়ের মধ্যে শেষ হওয়া সেশনগুলি প্রতিক্রিয়াতে অন্তর্ভুক্ত করা হবে। যদি এই সময়টি বাদ দেওয়া হয় কিন্তু startTime নির্দিষ্ট করা থাকে, তাহলে startTime থেকে শেষ সময় পর্যন্ত সমস্ত সেশন ফেরত দেওয়া হবে।
includeDeleted boolean যদি সত্য হয়, এবং যদি উভয় startTime এবং endTime বাদ দেওয়া হয়, সেশন মুছে ফেলা হবে।
pageToken string ধারাবাহিকতা টোকেন, যা ক্রমবর্ধমান সিঙ্কিংয়ের জন্য ব্যবহৃত হয়। পরিবর্তনের পরবর্তী ব্যাচ পেতে, এই পরামিতিটিকে পূর্ববর্তী প্রতিক্রিয়া থেকে nextPageToken এর মান নির্ধারণ করুন। পৃষ্ঠা টোকেন উপেক্ষা করা হয় যদি হয় শুরু বা শেষ সময় নির্দিষ্ট করা হয়। যদি শুরুর সময়, শেষ সময় এবং পৃষ্ঠার টোকেন নির্দিষ্ট করা না থাকে, তাহলে গত 30 দিনে পরিবর্তিত সেশনগুলি ফেরত দেওয়া হয়।
startTime string একটি RFC3339 টাইমস্ট্যাম্প। শুধুমাত্র শুরু এবং শেষ সময়ের মধ্যে শেষ হওয়া সেশনগুলি প্রতিক্রিয়াতে অন্তর্ভুক্ত করা হবে। যদি এই সময়টি বাদ দেওয়া হয় কিন্তু endTime নির্দিষ্ট করা হয়, তবে শুরুর সময় থেকে endTime পর্যন্ত সমস্ত সেশন ফেরত দেওয়া হবে৷

অনুমোদন

এই অনুরোধের জন্য নিম্নলিখিত স্কোপের মধ্যে অন্তত একটির সাথে অনুমোদনের প্রয়োজন:

ব্যাপ্তি
https://www.googleapis.com/auth/fitness.activity.read
https://www.googleapis.com/auth/fitness.activity.write
https://www.googleapis.com/auth/fitness.location.read
https://www.googleapis.com/auth/fitness.location.write
https://www.googleapis.com/auth/fitness.body.read
https://www.googleapis.com/auth/fitness.body.write
https://www.googleapis.com/auth/fitness.nutrition.read
https://www.googleapis.com/auth/fitness.nutrition.write
https://www.googleapis.com/auth/fitness.blood_pressure.read
https://www.googleapis.com/auth/fitness.blood_pressure.write
https://www.googleapis.com/auth/fitness.blood_glucose.read
https://www.googleapis.com/auth/fitness.blood_glucose.write
https://www.googleapis.com/auth/fitness.oxygen_saturation.read
https://www.googleapis.com/auth/fitness.oxygen_saturation.write
https://www.googleapis.com/auth/fitness.body_temperature.read
https://www.googleapis.com/auth/fitness.body_temperature.write
https://www.googleapis.com/auth/fitness.reproductive_health.read
https://www.googleapis.com/auth/fitness.reproductive_health.write

আরও তথ্যের জন্য, প্রমাণীকরণ এবং অনুমোদন পৃষ্ঠাটি দেখুন।

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

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

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

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

{
  "session": [
    {
      "id": string,
      "name": string,
      "description": string,
      "startTimeMillis": long,
      "endTimeMillis": long,
      "modifiedTimeMillis": long,
      "application": {
        "packageName": string,
        "version": string,
        "detailsUrl": string,
        "name": string
      },
      "activityType": integer,
      "activeTimeMillis": long
    }
  ],
  "deletedSession": [
    {
      "id": string,
      "name": string,
      "description": string,
      "startTimeMillis": long,
      "endTimeMillis": long,
      "modifiedTimeMillis": long,
      "application": {
        "packageName": string,
        "version": string,
        "detailsUrl": string,
        "name": string
      },
      "activityType": integer,
      "activeTimeMillis": long
    }
  ],
  "nextPageToken": string,
  "hasMoreData": boolean
}
সম্পত্তির নাম মান বর্ণনা নোট
session[] list অনুরোধের startTime এবং endTime মধ্যে শেষ সময় সহ সেশন।

session[]. id string একটি ক্লায়েন্ট-জেনারেটেড শনাক্তকারী যা এই নির্দিষ্ট ব্যবহারকারীর মালিকানাধীন সমস্ত সেশন জুড়ে অনন্য।
session[]. name string সেশনের একটি মানব পাঠযোগ্য নাম।
session[]. description string এই অধিবেশনের জন্য একটি বিবরণ.
session[]. startTimeMillis long একটি শুরুর সময়, যুগ থেকে মিলিসেকেন্ডে, অন্তর্ভুক্ত।
session[]. endTimeMillis long একটি শেষ সময়, যুগ থেকে মিলিসেকেন্ডে, অন্তর্ভুক্ত।
session[]. modifiedTimeMillis long একটি টাইমস্ট্যাম্প যা নির্দেশ করে কখন সেশনটি শেষবার সংশোধন করা হয়েছিল৷
session[]. application nested object যে অ্যাপ্লিকেশনটি সেশন তৈরি করেছে।
session[].application. packageName string এই অ্যাপ্লিকেশনের জন্য প্যাকেজ নাম. এটি একটি অনন্য শনাক্তকারী হিসাবে ব্যবহৃত হয় যখন Android অ্যাপ্লিকেশনগুলি তৈরি করে, কিন্তু REST ক্লায়েন্টদের দ্বারা নির্দিষ্ট করা যায় না৷ REST ক্লায়েন্টদের তাদের ডেভেলপার প্রজেক্ট নম্বর প্যাকেজ নামের পরিবর্তে ডেটা সোর্স ডেটা স্ট্রিম আইডিতে প্রতিফলিত হবে।
session[].application. version string অ্যাপ্লিকেশনটির সংস্করণ। আপনার এই ক্ষেত্রটি আপডেট করা উচিত যখনই অ্যাপ্লিকেশনটি এমনভাবে পরিবর্তিত হয় যা ডেটা গণনাকে প্রভাবিত করে।
session[].application. detailsUrl string একটি ঐচ্ছিক ইউআরআই যা অ্যাপ্লিকেশনে আবার লিঙ্ক করতে ব্যবহার করা যেতে পারে।
session[].application. name string এই অ্যাপ্লিকেশনটির নাম। এটি REST ক্লায়েন্টদের জন্য প্রয়োজনীয়, কিন্তু আমরা এই নামের স্বতন্ত্রতা প্রয়োগ করি না। এটি অন্যান্য ডেভেলপারদের জন্য সুবিধার বিষয় হিসাবে প্রদান করা হয়েছে যারা সনাক্ত করতে চান কোন REST একটি অ্যাপ্লিকেশন বা ডেটা উত্স তৈরি করেছে৷
session[]. activityType integer কার্যকলাপের ধরন এই অধিবেশন প্রতিনিধিত্ব করে.
deletedSession[] list যদি অনুরোধে includeDeleted সত্য হিসাবে সেট করা হয় এবং startTime এবং endTime বাদ দেওয়া হয়, তবে এতে সেশনগুলি অন্তর্ভুক্ত থাকবে যা শেষ সিঙ্কের পর থেকে মুছে ফেলা হয়েছিল।
deletedSession[]. id string একটি ক্লায়েন্ট-জেনারেটেড শনাক্তকারী যা এই নির্দিষ্ট ব্যবহারকারীর মালিকানাধীন সমস্ত সেশন জুড়ে অনন্য।
deletedSession[]. name string সেশনের একটি মানব পাঠযোগ্য নাম।
deletedSession[]. description string এই অধিবেশনের জন্য একটি বিবরণ.
deletedSession[]. startTimeMillis long একটি শুরুর সময়, যুগ থেকে মিলিসেকেন্ডে, অন্তর্ভুক্ত।
deletedSession[]. endTimeMillis long একটি শেষ সময়, যুগ থেকে মিলিসেকেন্ডে, অন্তর্ভুক্ত।
deletedSession[]. modifiedTimeMillis long একটি টাইমস্ট্যাম্প যা নির্দেশ করে কখন সেশনটি শেষবার সংশোধন করা হয়েছিল৷
deletedSession[]. application nested object যে অ্যাপ্লিকেশনটি সেশন তৈরি করেছে।
deletedSession[].application. packageName string এই অ্যাপ্লিকেশনের জন্য প্যাকেজ নাম. এটি একটি অনন্য শনাক্তকারী হিসাবে ব্যবহৃত হয় যখন Android অ্যাপ্লিকেশনগুলি তৈরি করে, কিন্তু REST ক্লায়েন্টদের দ্বারা নির্দিষ্ট করা যায় না৷ REST ক্লায়েন্টদের তাদের ডেভেলপার প্রজেক্ট নম্বর প্যাকেজ নামের পরিবর্তে ডেটা সোর্স ডেটা স্ট্রিম আইডিতে প্রতিফলিত হবে।
deletedSession[].application. version string অ্যাপ্লিকেশনটির সংস্করণ। আপনার এই ক্ষেত্রটি আপডেট করা উচিত যখনই অ্যাপ্লিকেশনটি এমনভাবে পরিবর্তিত হয় যা ডেটা গণনাকে প্রভাবিত করে।
deletedSession[].application. detailsUrl string একটি ঐচ্ছিক ইউআরআই যা অ্যাপ্লিকেশনে আবার লিঙ্ক করতে ব্যবহার করা যেতে পারে।
deletedSession[].application. name string এই অ্যাপ্লিকেশনটির নাম। এটি REST ক্লায়েন্টদের জন্য প্রয়োজনীয়, কিন্তু আমরা এই নামের স্বতন্ত্রতা প্রয়োগ করি না। এটি অন্যান্য ডেভেলপারদের জন্য সুবিধার বিষয় হিসাবে প্রদান করা হয়েছে যারা সনাক্ত করতে চান কোন REST একটি অ্যাপ্লিকেশন বা ডেটা উত্স তৈরি করেছে৷
deletedSession[]. activityType integer কার্যকলাপের ধরন এই অধিবেশন প্রতিনিধিত্ব করে.
nextPageToken string সিঙ্ক টোকেন যা আরও পরিবর্তন সিঙ্ক করতে ব্যবহৃত হয়। অনুরোধ থেকে startTime এবং endTime উভয়ই বাদ দিলেই এটি প্রদান করা হবে।
session[]. activeTimeMillis long সেশন সক্রিয় সময়. যদিও start_time_millis এবং end_time_millis সম্পূর্ণ সেশনের সময় নির্ধারণ করে, সক্রিয় সময় ছোট হতে পারে এবং সক্রিয়_সময়_মিলিস দ্বারা নির্দিষ্ট করা যেতে পারে। অধিবেশন চলাকালীন নিষ্ক্রিয় সময় জানা থাকলে, এটি একটি STILL কার্যকলাপ মান সহ একটি com.google.activity.segment ডেটা পয়েন্টের মাধ্যমেও ঢোকানো উচিত

deletedSession[]. activeTimeMillis long সেশন সক্রিয় সময়. যদিও start_time_millis এবং end_time_millis সম্পূর্ণ সেশনের সময় নির্ধারণ করে, সক্রিয় সময় ছোট হতে পারে এবং সক্রিয়_সময়_মিলিস দ্বারা নির্দিষ্ট করা যেতে পারে। অধিবেশন চলাকালীন নিষ্ক্রিয় সময় জানা থাকলে, এটি একটি STILL কার্যকলাপ মান সহ একটি com.google.activity.segment ডেটা পয়েন্টের মাধ্যমেও ঢোকানো উচিত

hasMoreData boolean সার্ভারে আরও ডেটা স্থানান্তর করার জন্য ফ্ল্যাগ করুন। এই ক্ষেত্রটি ব্যবহার করবেন না। এটি সার্ভারের প্রতিক্রিয়াগুলিতে কখনই জনবহুল হয় না।

এটা চেষ্টা করুন!

লাইভ ডেটাতে এই পদ্ধতিতে কল করতে এবং প্রতিক্রিয়া দেখতে নীচের APIs এক্সপ্লোরার ব্যবহার করুন।