AppRequest

AppRequest হল Google অ্যাসিস্ট্যান্ট দ্বারা একটি অ্যাকশনের সাথে ইন্টারঅ্যাক্ট করার জন্য একটি পূরণের জন্য পাঠানো একটি অনুরোধ। API সংস্করণটি HTTP হেডারে নির্দিষ্ট করা আছে। API সংস্করণ 1-এর জন্য, শিরোনামে রয়েছে: Google-Assistant-API-Version: v1 । API সংস্করণ 2-এর জন্য, শিরোনামে রয়েছে: Google-actions-API-Version: 2 । Google-এর অ্যাকশনে এটি কীভাবে ব্যবহার করা হয় তার উদাহরণের জন্য, https://developers.google.com/assistant/df-asdk/reference/conversation-webhook-json দেখুন।

JSON প্রতিনিধিত্ব
{
  "user": {
    object (User)
  },
  "device": {
    object (Device)
  },
  "surface": {
    object (Surface)
  },
  "conversation": {
    object (Conversation)
  },
  "inputs": [
    {
      object (Input)
    }
  ],
  "isInSandbox": boolean,
  "availableSurfaces": [
    {
      object (Surface)
    }
  ]
}
ক্ষেত্র
user

object ( User )

যে ব্যবহারকারী কথোপকথন শুরু করেছেন।

device

object ( Device )

অ্যাকশনের সাথে ইন্টারঅ্যাক্ট করার জন্য ব্যবহারকারী যে ডিভাইসটি ব্যবহার করছেন সে সম্পর্কে তথ্য।

surface

object ( Surface )

ব্যবহারকারী যে পৃষ্ঠের সাথে ইন্টারঅ্যাক্ট করছেন সে সম্পর্কে তথ্য, যেমন এটি অডিও আউটপুট করতে পারে বা একটি স্ক্রিন আছে কিনা।

conversation

object ( Conversation )

কথোপকথন আইডি এবং কথোপকথনের টোকেনের মতো সেশন ডেটা ধারণ করে।

inputs[]

object ( Input )

অ্যাকশন দ্বারা নির্দিষ্ট করা প্রত্যাশিত ইনপুটগুলির সাথে সম্পর্কিত ইনপুটগুলির তালিকা৷ প্রাথমিক কথোপকথন ট্রিগারের জন্য, ইনপুটটিতে ব্যবহারকারী কীভাবে কথোপকথনটি ট্রিগার করেছে তার তথ্য রয়েছে৷

isInSandbox

boolean

অনুরোধ স্যান্ডবক্স মোডে পরিচালনা করা উচিত কিনা তা নির্দেশ করে।

availableSurfaces[]

object ( Surface )

ক্রস সারফেস হ্যান্ডঅফের জন্য উপলব্ধ সারফেস।

ব্যবহারকারী

JSON প্রতিনিধিত্ব
{
  "idToken": string,
  "profile": {
    object (UserProfile)
  },
  "accessToken": string,
  "permissions": [
    enum (Permission)
  ],
  "locale": string,
  "lastSeen": string,
  "userStorage": string,
  "packageEntitlements": [
    {
      object (PackageEntitlement)
    }
  ],
  "userVerificationStatus": enum (UserVerificationStatus)
}
ক্ষেত্র
idToken

string

টোকেন ব্যবহারকারীর পরিচয় প্রতিনিধিত্ব করে। এটি এনকোড করা প্রোফাইল সহ একটি Json ওয়েব টোকেন। সংজ্ঞাটি https://developers.google.com/identity/protocols/OpenIDConnect#obtainuserinfo- এ দেওয়া আছে।

profile

object ( UserProfile )

শেষ ব্যবহারকারী সম্পর্কে তথ্য। কিছু ক্ষেত্র শুধুমাত্র উপলভ্য হয় যদি ব্যবহারকারী অ্যাকশনে এই তথ্য প্রদানের অনুমতি দেয়।

accessToken

string

একটি OAuth2 টোকেন যা আপনার সিস্টেমে ব্যবহারকারীকে শনাক্ত করে। শুধুমাত্র ব্যবহারকারী তাদের অ্যাকাউন্ট লিঙ্ক করলেই উপলব্ধ।

permissions[]

enum ( Permission )

এই ক্রিয়াকলাপের জন্য ব্যবহারকারীর দ্বারা প্রদত্ত অনুমতি রয়েছে৷

locale

string

অনুরোধ করা ব্যবহারকারীর প্রাথমিক লোকেল সেটিং। IETF BCP-47 ভাষার কোড অনুসরণ করে http://www.rfc-editor.org/rfc/bcp/bcp47.txt যাইহোক, স্ক্রিপ্ট সাবট্যাগ অন্তর্ভুক্ত করা হয়নি।

lastSeen

string ( Timestamp format)

এই ব্যবহারকারীর সাথে শেষ ইন্টারঅ্যাকশনের টাইমস্ট্যাম্প। এই ক্ষেত্রটি বাদ দেওয়া হবে যদি ব্যবহারকারী আগে এজেন্টের সাথে যোগাযোগ না করে থাকে।

RFC3339 UTC "জুলু" ফর্ম্যাটে একটি টাইমস্ট্যাম্প, ন্যানোসেকেন্ডের জন্য সঠিক। উদাহরণ: "2014-10-02T15:01:23.045123456Z"

userStorage

string

অ্যাপ্লিকেশন দ্বারা সরবরাহ করা একটি অস্বচ্ছ টোকেন যা একটি নির্দিষ্ট ব্যবহারকারীর জন্য কথোপকথন জুড়ে থাকে। স্ট্রিংয়ের সর্বাধিক আকার 10k অক্ষর।

packageEntitlements[]

object ( PackageEntitlement )

অ্যাকশন প্যাকেজে তালিকাভুক্ত প্রতিটি প্যাকেজের নামের জন্য ব্যবহারকারীর এনটাইটেলমেন্টের তালিকা, যদি থাকে।

userVerificationStatus

enum ( UserVerificationStatus )

ব্যবহারকারীর যাচাইকরণের অবস্থা নির্দেশ করে।

ব্যবহারকারী প্রোফাইল

ব্যবহারকারীর ব্যক্তিগত তথ্য ধারণ করে। ক্ষেত্রগুলি শুধুমাত্র তখনই জনবহুল হয় যখন ব্যবহারকারী ব্যবহারকারী একটি নির্দিষ্ট ক্ষেত্রের জন্য অ্যাকশনের অনুমতি দেয়।

JSON প্রতিনিধিত্ব
{
  "displayName": string,
  "givenName": string,
  "familyName": string
}
ক্ষেত্র
displayName

string

ব্যবহারকারীর পুরো নাম যেমন তাদের Google অ্যাকাউন্টে উল্লেখ করা আছে। NAME অনুমতির প্রয়োজন৷

givenName

string

ব্যবহারকারীর প্রথম নামটি তাদের Google অ্যাকাউন্টে উল্লেখ করা হয়েছে। NAME অনুমতির প্রয়োজন৷

familyName

string

ব্যবহারকারীর শেষ নামটি তাদের Google অ্যাকাউন্টে উল্লেখ করা হয়েছে। মনে রাখবেন এই ক্ষেত্রটি খালি হতে পারে। NAME অনুমতির প্রয়োজন৷

প্যাকেজ এনটাইটেলমেন্ট

একটি প্যাকেজ নামের সাথে সম্পর্কিত এনটাইটেলমেন্টের তালিকা

JSON প্রতিনিধিত্ব
{
  "packageName": string,
  "entitlements": [
    {
      object (Entitlement)
    }
  ]
}
ক্ষেত্র
packageName

string

অ্যাকশন প্যাকেজে প্যাকেজের নামের সাথে মিলিত হওয়া উচিত

entitlements[]

object ( Entitlement )

একটি প্রদত্ত অ্যাপের জন্য এনটাইটেলমেন্টের তালিকা

এনটাইটেলমেন্ট

ব্যবহারকারীর ডিজিটাল এনটাইটেলমেন্ট সংজ্ঞায়িত করে। সম্ভাব্য এনটাইটেলমেন্টের প্রকার: অর্থপ্রদান-অ্যাপ, অ্যাপ-মধ্যস্থ কেনাকাটা, অ্যাপ-মধ্যস্থ সদস্যতা।

JSON প্রতিনিধিত্ব
{
  "sku": string,
  "skuType": enum (SkuType),
  "inAppDetails": {
    object (SignedData)
  }
}
ক্ষেত্র
sku

string

পণ্য sku. পেইড অ্যাপের জন্য প্যাকেজের নাম, অ্যাপ-মধ্যস্থ কেনাকাটার জন্য ফিনস্কি ডসিডের প্রত্যয় এবং অ্যাপ-মধ্যস্থ সাবস্ক্রিপশন। Play InApp বিলিং এপিআই-এ getSku() মেলে।

skuType

enum ( SkuType )

inAppDetails

object ( SignedData )

শুধুমাত্র অ্যাপ-মধ্যস্থ ক্রয় এবং অ্যাপ-মধ্যস্থ সদস্যদের জন্য উপস্থিত।

স্বাক্ষরিত ডেটা

JSON প্রতিনিধিত্ব
{
  "inAppPurchaseData": {
    object
  },
  "inAppDataSignature": string
}
ক্ষেত্র
inAppPurchaseData

object ( Struct format)

getPurchases() পদ্ধতি থেকে INAPP_PURCHASE_DATA মেলে। JSON ফরম্যাটে সমস্ত ইনঅ্যাপ ক্রয় ডেটা রয়েছে https://developer.android.com/google/play/billing/billing_reference.html এর সারণি 6-এ বিশদ বিবরণ দেখুন।

inAppDataSignature

string

Play InApp বিলিং API-এ getPurchases() পদ্ধতি থেকে IN_APP_DATA_SIGNATURE মেলে।

যন্ত্র

অ্যাকশনের সাথে ইন্টারঅ্যাক্ট করার জন্য ব্যবহারকারী যে ডিভাইসটি ব্যবহার করছেন সে সম্পর্কে তথ্য।

JSON প্রতিনিধিত্ব
{
  "location": {
    object (Location)
  }
}
ক্ষেত্র
location

object ( Location )

প্রকৃত ডিভাইসের অবস্থান যেমন অক্ষাংশ, দ্রাঘিমাংশ, এবং বিন্যাসিত ঠিকানার প্রতিনিধিত্ব করে। DEVICE_COARSE_LOCATION বা DEVICE_PRECISE_LOCATION অনুমতির প্রয়োজন৷

পৃষ্ঠতল

Google অ্যাসিস্ট্যান্ট ক্লায়েন্ট সারফেসের নির্দিষ্ট তথ্য যার সাথে ব্যবহারকারী ইন্টারঅ্যাক্ট করছেন। সারফেসকে ডিভাইস থেকে আলাদা করা হয় যে একই ডিভাইসে একাধিক অ্যাসিস্ট্যান্ট সারফেস থাকতে পারে।

JSON প্রতিনিধিত্ব
{
  "capabilities": [
    {
      object (Capability)
    }
  ]
}
ক্ষেত্র
capabilities[]

object ( Capability )

অনুরোধের সময় পৃষ্ঠটি সমর্থন করে এমন ক্ষমতার একটি তালিকা যেমন actions.capability.AUDIO_OUTPUT

সামর্থ্য

কার্যকারিতার একটি ইউনিটকে প্রতিনিধিত্ব করে যা পৃষ্ঠটি সমর্থন করতে সক্ষম।

JSON প্রতিনিধিত্ব
{
  "name": string
}
ক্ষেত্র
name

string

ক্ষমতার নাম, যেমন actions.capability.AUDIO_OUTPUT

কথোপকথন

JSON প্রতিনিধিত্ব
{
  "conversationId": string,
  "type": enum (ConversationType),
  "conversationToken": string
}
ক্ষেত্র
conversationId

string

মাল্টি-টার্ন কথোপকথনের জন্য অনন্য আইডি। এটা প্রথম পালা জন্য বরাদ্দ করা হয়েছে. এর পরে কথোপকথন বন্ধ না হওয়া পর্যন্ত পরবর্তী কথোপকথনের মোড়ের জন্য এটি একই থাকে।

type

enum ( ConversationType )

টাইপ তার জীবনচক্রে কথোপকথনের অবস্থা নির্দেশ করে।

conversationToken

string

শেষ কথোপকথনের মোড়কে অ্যাকশন দ্বারা নির্দিষ্ট করা অস্বচ্ছ টোকেন। কথোপকথন ট্র্যাক করতে বা কথোপকথন সম্পর্কিত ডেটা সংরক্ষণ করতে এটি একটি অ্যাকশন দ্বারা ব্যবহার করা যেতে পারে।

ইনপুট

JSON প্রতিনিধিত্ব
{
  "rawInputs": [
    {
      object (RawInput)
    }
  ],
  "intent": string,
  "arguments": [
    {
      object (Argument)
    }
  ]
}
ক্ষেত্র
rawInputs[]

object ( RawInput )

কথোপকথনের প্রতিটি মোড় থেকে কাঁচা ইনপুট প্রতিলিপি। Google-এ অ্যাকশনে কিছু ধরনের ইনপুট দেওয়ার জন্য একাধিক কথোপকথনের মোড়ের প্রয়োজন হতে পারে।

intent

string

ব্যবহারকারীর অভিপ্রায় নির্দেশ করে। প্রথম কথোপকথনের মোড়ের জন্য, উদ্দেশ্যটি অ্যাকশনের জন্য ট্রিগারিং অভিপ্রায়কে নির্দেশ করবে। পরবর্তী কথোপকথনের মোড়ের জন্য, অভিপ্রায়টি হবে Google অভিপ্রায়ে একটি সাধারণ ক্রিয়া ('ক্রিয়া দিয়ে শুরু হয়৷')৷ উদাহরণস্বরূপ, যদি প্রত্যাশিত ইনপুটটি হয় actions.intent.OPTION , তাহলে এখানে উল্লেখিত অভিপ্রায়টি হয় actions.intent.OPTION হবে যদি Google সহকারী সেই অভিপ্রায়টি পূরণ করতে সক্ষম হয়, অথবা ব্যবহারকারী যদি অন্যটি প্রদান করে তাহলে actions.intent.TEXT তথ্য https://developers.google.com/assistant/df-asdk/reference/intents দেখুন।

arguments[]

object ( Argument )

অ্যাকশন দ্বারা অনুরোধ করা ইনপুটের জন্য প্রদত্ত আর্গুমেন্ট মানগুলির একটি তালিকা৷

কাঁচা নিবেশ

JSON প্রতিনিধিত্ব
{
  "inputType": enum (InputType),

  // Union field input can be only one of the following:
  "query": string,
  "url": string
  // End of list of possible types for union field input.
}
ক্ষেত্র
inputType

enum ( InputType )

ব্যবহারকারী কিভাবে এই ইনপুট প্রদান করেছে তা নির্দেশ করে: একটি টাইপ করা প্রতিক্রিয়া, একটি ভয়েস প্রতিক্রিয়া, অনির্দিষ্ট, ইত্যাদি।

ইউনিয়ন ফিল্ড input । প্রকৃত ইনপুট মান input নিম্নলিখিতগুলির মধ্যে একটি হতে পারে:
query

string

শেষ ব্যবহারকারীর কাছ থেকে টাইপ করা বা কথ্য ইনপুট।

url

string

ট্রিগারিং URL।