REST Resource: brands.agents

সম্পদ: এজেন্ট

একটি কথোপকথন সত্তা যা একটি ব্র্যান্ডের প্রতিনিধিত্ব করে।

JSON প্রতিনিধিত্ব
{
  "name": string,
  "displayName": string,

  // Union field detail_info can be only one of the following:
  "businessMessagesAgent": {
    object (BusinessMessagesAgent)
  }
  // End of list of possible types for union field detail_info.
}
ক্ষেত্র
name

string

এজেন্টের অনন্য শনাক্তকারী।

শুধুমাত্র পাঠযোগ্য. প্ল্যাটফর্ম দ্বারা সংজ্ঞায়িত।

displayName

string

প্রয়োজন। এজেন্ট ব্যবহারকারীদের কাছে যে নামটি প্রদর্শন করে। সর্বোচ্চ 100টি অক্ষর।

এজেন্ট যাচাইকরণের পরে পরিবর্তনযোগ্য নয়।

ইউনিয়ন ক্ষেত্রের detail_info । নির্দিষ্ট পণ্যের জন্য প্রয়োজনীয় ক্ষেত্র রয়েছে।

প্রয়োজন। detail_info নিম্নলিখিতগুলির মধ্যে একটি হতে পারে:

businessMessagesAgent

object ( BusinessMessagesAgent )

ব্যবসায়িক বার্তার জন্য বিস্তারিত এজেন্ট তথ্য।

BusinessMessagesAgent

ব্যবসা বার্তার জন্য নির্দিষ্ট এজেন্ট তথ্য।

JSON প্রতিনিধিত্ব
{
  "logoUrl": string,
  "entryPointConfigs": [
    {
      object (BusinessMessagesEntryPointConfig)
    }
  ],
  "conversationalSettings": {
    string: {
      object (ConversationalSetting)
    },
    ...
  },
  "defaultLocale": string,
  "primaryAgentInteraction": {
    object (SupportedAgentInteraction)
  },
  "additionalAgentInteractions": [
    {
      object (SupportedAgentInteraction)
    }
  ],
  "customAgentId": string,
  "agentTestUrl": string,
  "testUrls": [
    {
      object (TestUrl)
    }
  ],
  "phone": {
    object (Phone)
  },
  "authorizationConfig": {
    object (AuthorizationConfig)
  },
  "nonLocalConfig": {
    object (NonLocalConfig)
  },
  "surveyConfig": {
    object (SurveyConfig)
  }
}
ক্ষেত্র
logoUrl

string

ঐচ্ছিক। এজেন্টের জন্য লোগোর ইউআরএল সর্বজনীনভাবে উপলব্ধ। সর্বাধিক 50 KB।

এজেন্ট যাচাইকরণের পরে পরিবর্তনযোগ্য নয়।

entryPointConfigs[]

object ( BusinessMessagesEntryPointConfig )

ঐচ্ছিক। এন্ট্রি পয়েন্ট কনফিগারেশনের তালিকা।

এজেন্ট যাচাইকরণের পরে পরিবর্তনযোগ্য নয়।

conversationalSettings

map (key: string, value: object ( ConversationalSetting ))

প্রয়োজন। একটি এজেন্টের জন্য কথোপকথন সেটিংস, একটি লোকেলে ম্যাপ করা হয়েছে। লোকেল একটি সুগঠিত IETF BCP 47 ভাষা ট্যাগ দ্বারা প্রতিনিধিত্ব করা হয়।

"key": value জোড়া। উদাহরণ: { "name": "wrench", "mass": "1.3kg", "count": "3" }

defaultLocale

string

প্রয়োজন। এজেন্টের জন্য ডিফল্ট লোকেল। conversationalSettings সংজ্ঞায়িত একটি লোকেলের সাথে মিলতে হবে।

primaryAgentInteraction

object ( SupportedAgentInteraction )

প্রয়োজন। প্রাথমিক এজেন্ট মিথস্ক্রিয়া তথ্য. ব্যবহারকারী যখন একটি কথোপকথন শুরু করে তখন ব্যবহার করা হয়।

additionalAgentInteractions[]

object ( SupportedAgentInteraction )

ঐচ্ছিক। অতিরিক্ত এজেন্ট মিথস্ক্রিয়া তথ্য. একাধিক ইন্টারঅ্যাকশন প্রকারকে সমর্থন করতে এজেন্টকে সক্ষম করে।

customAgentId

string

ঐচ্ছিক। এজেন্টের জন্য একটি অংশীদার-নির্দিষ্ট শনাক্তকারী। শনাক্তকারীকে এজেন্টকে পাঠানো সমস্ত বার্তার পাশাপাশি পাস করা হয়।

agentTestUrl
(deprecated)

string

শুধুমাত্র আউটপুট। এজেন্টের কথোপকথন অভিজ্ঞতা পরীক্ষা করার জন্য URL।

প্ল্যাটফর্ম দ্বারা সংজ্ঞায়িত।

testUrls[]

object ( TestUrl )

শুধুমাত্র আউটপুট। এজেন্টের কথোপকথন অভিজ্ঞতা পরীক্ষা করার জন্য URL।

প্ল্যাটফর্ম দ্বারা সংজ্ঞায়িত।

phone

object ( Phone )

ঐচ্ছিক। এজেন্ট দেখানোর জন্য ফোন নম্বর। নির্দিষ্ট না করা থাকলে, এজেন্ট Google নলেজ গ্রাফে পাওয়া ব্র্যান্ডের ফোন নম্বর প্রদর্শন করে, যদি থাকে।

authorizationConfig

object ( AuthorizationConfig )

ঐচ্ছিক। OAuth সমর্থনের জন্য অনুমোদন কনফিগারেশন।

nonLocalConfig

object ( NonLocalConfig )

ঐচ্ছিক। অ-স্থানীয় এন্ট্রি পয়েন্টের জন্য কনফিগারেশন।

surveyConfig

object ( SurveyConfig )

ঐচ্ছিক। কাস্টম সার্ভে সক্ষম করতে কনফিগারেশন।

BusinessMessagesEntryPointConfig

এজেন্টের জন্য এন্ট্রি পয়েন্ট কনফিগারেশন।

JSON প্রতিনিধিত্ব
{
  "allowedEntryPoint": enum (EntryPoint)
}
ক্ষেত্র
allowedEntryPoint

enum ( EntryPoint )

প্রয়োজন। Google যে সারফেসগুলিতে এজেন্টকে দেখাতে সক্ষম করা হয়েছে।

এন্ট্রিপয়েন্ট

Google যে সারফেসগুলিতে এজেন্টকে দেখাতে সক্ষম করা হয়েছে।

এনামস
ENTRY_POINT_UNSPECIFIED অনির্দিষ্ট প্রবেশ বিন্দু.
LOCATION এই এজেন্টের জন্য অবস্থানগুলি সক্ষম করুন৷
NON_LOCAL অ-স্থানীয় এন্ট্রি পয়েন্টের জন্য ব্যবসা বার্তা সক্ষম করুন।

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

একটি এজেন্ট দ্বারা সমর্থিত মিথস্ক্রিয়া.

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

  // Union field representative can be only one of the following:
  "botRepresentative": {
    object (BotRepresentative)
  },
  "humanRepresentative": {
    object (HumanRepresentative)
  }
  // End of list of possible types for union field representative.
}
ক্ষেত্র
interactionType

enum ( InteractionType )

প্রয়োজন। এজেন্ট দ্বারা সমর্থিত মিথস্ক্রিয়া প্রকার।

ইউনিয়ন মাঠ representative । কনফিগার প্রকারের জন্য বিস্তারিত তথ্য। প্রয়োজন। representative নিম্নলিখিতগুলির মধ্যে একটি হতে পারে:
botRepresentative

object ( BotRepresentative )

বট প্রতিনিধি বিবরণ.

humanRepresentative

object ( HumanRepresentative )

মানব প্রতিনিধি বিবরণ.

ইন্টারঅ্যাকশন টাইপ

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

এনামস
INTERACTION_TYPE_UNSPECIFIED অনির্দিষ্ট মিথস্ক্রিয়া।
BOT বট মিথস্ক্রিয়া।
HUMAN মানুষের মিথস্ক্রিয়া.

বট প্রতিনিধি

বট প্রতিনিধির জন্য বিশদ বিবরণ।

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

object ( MessagingAvailability )

প্রয়োজন। বট মেসেজিং প্রাপ্যতা.

মেসেজিং উপলভ্যতা

সপ্তাহের প্রতিটি দিনের ঘন্টা যে মেসেজিং উপলব্ধ। আপনি একসাথে একাধিক দিনের জন্য ঘন্টা গ্রুপ করতে পারেন। উদাহরণস্বরূপ, * 08:00–16:00 hrs PDT সোমবার-বুধবার * 10:00–14:00 hrs PDT বৃহস্পতি-শুক্রবার * 15:00–18:00 hrs PDT বৃহস্পতিবার-শুক্রবার * 10:00–14:00 PDT শনিবার-শনিবার

যদি প্রাপ্যতার মধ্যে ফাঁক থাকে, যেমন রবিবারে কোনো নির্দিষ্ট উপলব্ধতা না থাকে, সেই ফাঁকের সময় বার্তা পাঠানো অনুপলব্ধ।

বট ঘন্টা প্রাপ্যতা উপর কোন প্রভাব আছে. শুধুমাত্র বট এজেন্ট সবসময় একটি স্বাগত বার্তা প্রদর্শন করে, যখন মানব এবং বট উভয় প্রতিনিধি সেটিংস সহ এজেন্টরা উপলব্ধতা নির্ধারণ করার সময় শুধুমাত্র মানব প্রতিনিধিদের বিবেচনা করে।

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

object ( Hours )

প্রয়োজন। মেসেজিং প্রাপ্যতা ঘন্টা.

ঘন্টার

ঘন্টার একটি পরিসীমা যে মেসেজিং উপলব্ধ.

JSON প্রতিনিধিত্ব
{
  "startTime": {
    object (TimeOfDay)
  },
  "endTime": {
    object (TimeOfDay)
  },
  "timeZone": string,
  "startDay": enum (DayOfWeek),
  "endDay": enum (DayOfWeek)
}
ক্ষেত্র
startTime

object ( TimeOfDay )

প্রয়োজন। সপ্তাহের দিনের পরিসরের মধ্যে প্রতিটি দিনের জন্য শুরু করার সময়।

endTime

object ( TimeOfDay )

প্রয়োজন। সপ্তাহের দিনের পরিসরের মধ্যে প্রতিটি দিনের জন্য শেষ সময়।

timeZone

string

প্রয়োজন। ঘন্টার জন্য IANA সময় অঞ্চল । উদাহরণস্বরূপ, "America/Los_Angeles"।

startDay

enum ( DayOfWeek )

প্রয়োজন। দিন শুরু.

endDay

enum ( DayOfWeek )

প্রয়োজন। শেষ দিন. নির্দিষ্ট দিন অন্তর্ভুক্ত.

দিনের সময়

দিনের একটি সময় প্রতিনিধিত্ব করে। তারিখ এবং সময় অঞ্চল হয় উল্লেখযোগ্য নয় বা অন্য কোথাও নির্দিষ্ট করা হয়েছে৷ একটি API লিপ সেকেন্ডের অনুমতি দিতে বেছে নিতে পারে। সম্পর্কিত প্রকারগুলি হল google.type.Date এবং google.protobuf.Timestamp

JSON প্রতিনিধিত্ব
{
  "hours": integer,
  "minutes": integer,
  "seconds": integer,
  "nanos": integer
}
ক্ষেত্র
hours

integer

24 ঘন্টা বিন্যাসে দিনের ঘন্টা. 0 থেকে 23 পর্যন্ত হওয়া উচিত। ব্যবসা বন্ধ হওয়ার সময় মত পরিস্থিতির জন্য একটি API "24:00:00" মানকে অনুমতি দিতে পারে।

minutes

integer

দিনের ঘন্টার মিনিট। 0 থেকে 59 এর মধ্যে হতে হবে।

seconds

integer

সময়ের মিনিটের সেকেন্ড। সাধারণত 0 থেকে 59 এর মধ্যে হতে হবে। একটি API 60 মান অনুমোদন করতে পারে যদি এটি লিপ-সেকেন্ডের অনুমতি দেয়।

nanos

integer

ন্যানোসেকেন্ডে সেকেন্ডের ভগ্নাংশ। 0 থেকে 999,999,999 পর্যন্ত হতে হবে।

সপ্তাহের দিন

সপ্তাহের একটি দিন প্রতিনিধিত্ব করে।

এনামস
DAY_OF_WEEK_UNSPECIFIED সপ্তাহের দিন অনির্দিষ্ট।
MONDAY সোমবার
TUESDAY মঙ্গলবার
WEDNESDAY বুধবার
THURSDAY বৃহস্পতিবার
FRIDAY শুক্রবার
SATURDAY শনিবার
SUNDAY রবিবার

মানব প্রতিনিধি

মানব প্রতিনিধির জন্য বিস্তারিত।

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

object ( MessagingAvailability )

প্রয়োজন। মানব বার্তা প্রাপ্যতা.

অনুমোদন কনফিগারেশন

ব্যবসায়িক বার্তাগুলিতে OAuth সমর্থন করার জন্য কনফিগারেশনের বিবরণ।

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

string

শেষ পয়েন্ট URL যেখানে ব্যবহারকারী লগ ইন করে।

NonLocalConfig

অ-স্থানীয় এন্ট্রি পয়েন্ট সক্রিয় করতে কনফিগারেশন।

JSON প্রতিনিধিত্ব
{
  "contactOption": {
    object (ContactOption)
  },
  "enabledDomains": [
    string
  ],
  "phoneNumber": {
    object (Phone)
  },
  "callDeflectionPhoneNumbers": [
    {
      object (Phone)
    }
  ],
  "regionCodes": [
    string
  ]
}
ক্ষেত্র
contactOption

object ( ContactOption )

প্রয়োজন। এজেন্টের যোগাযোগের তথ্য যা মেসেজিং বোতামের সাথে প্রদর্শিত হয়।

enabledDomains[]

string

প্রয়োজন। সাইটলিঙ্ক এন্ট্রি পয়েন্টের জন্য সক্ষম করার জন্য ডোমেন।

phoneNumber

object ( Phone )

প্রয়োজন। এজেন্টের ফোন নম্বর। নন-লোকাল এন্ট্রি পয়েন্ট থেকে শুরু হওয়া কথোপকথনের জন্য phone ক্ষেত্রটিকে ওভাররাইড করে। এই ফোন নম্বরটি সমস্ত কনফিগার করা অঞ্চলের জন্য ব্যবহার করা হবে৷

callDeflectionPhoneNumbers[]

object ( Phone )

প্রয়োজন। কল ডিফ্লেকশনের জন্য ফোন নম্বরের তালিকা।

regionCodes[]

string

প্রয়োজন। যেসব দেশে এজেন্টকে NON_LOCAL এন্ট্রি পয়েন্ট চালু করার অনুমতি দেওয়া হয়েছে সেসব দেশের জন্য CLDR অঞ্চলের কোডের তালিকা। NON_LOCAL এন্ট্রি পয়েন্টের জন্য প্রয়োজনীয়।

যোগাযোগের বিকল্প

মেসেজিং বোতাম ছাড়াও যোগাযোগের বিশদ প্রদর্শিত হয়।

JSON প্রতিনিধিত্ব
{
  "url": string,
  "options": [
    enum (Option)
  ]
}
ক্ষেত্র
url

string

প্রয়োজন। যে URLটির জন্য যোগাযোগের বিকল্প উপলব্ধ।

options[]

enum ( Option )

প্রয়োজন। নির্দিষ্ট URL-এর জন্য উপলব্ধ যোগাযোগ বিকল্পের তালিকা।

অপশন

যোগাযোগের বিকল্প।

এনামস
OPTION_UNSPECIFIED অনির্দিষ্ট
WEB_CHAT ওয়েব চ্যাট বিকল্প।
PHONE ফোন বিকল্প।
EMAIL ইমেল বিকল্প।
FAQS FAQ বিকল্প।
TWITTER টুইটার বিকল্প।
WHATSAPP হোয়াটসঅ্যাপ বিকল্প।

সার্ভে কনফিগারেশন

কাস্টমাইজড জরিপ প্রশ্ন সমর্থন করার জন্য কনফিগারেশন বিশদ.

JSON প্রতিনিধিত্ব
{
  "templateQuestionIds": [
    string
  ],
  "customSurveys": {
    string: {
      object (CustomSurveyConfig)
    },
    ...
  }
}
ক্ষেত্র
templateQuestionIds[]

string

একটি সমীক্ষায় অন্তর্ভুক্ত টেমপ্লেট প্রশ্নের জন্য টেমপ্লেট প্রশ্ন আইডিগুলির তালিকা৷

customSurveys

map (key: string, value: object ( CustomSurveyConfig ))

একটি এজেন্টের জন্য কাস্টম সমীক্ষা প্রশ্ন, একটি লোকেলে ম্যাপ করা। লোকেল একটি সুগঠিত IETF BCP 47 ভাষা ট্যাগ দ্বারা প্রতিনিধিত্ব করা হয়।

"key": value জোড়া। উদাহরণ: { "name": "wrench", "mass": "1.3kg", "count": "3" }

CustomSurveyConfig

একজন এজেন্টের জন্য কাস্টম সার্ভে কনফিগারেশন।

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

object ( SurveyQuestion )

কাস্টম প্রশ্নের তালিকা।

সমীক্ষা প্রশ্ন

প্রতিটি সমীক্ষা প্রশ্নের বিস্তারিত বিষয়বস্তু।

JSON প্রতিনিধিত্ব
{
  "name": string,
  "questionType": enum (Type),
  "questionContent": string,
  "responseOptions": [
    {
      object (SurveyResponse)
    }
  ]
}
ক্ষেত্র
name

string

প্রয়োজন। প্রশ্নের অনন্য শনাক্তকারী।

questionType

enum ( Type )

শুধুমাত্র আউটপুট। প্রশ্নের ধরন।

questionContent

string

প্রয়োজন। প্রশ্ন বিষয়বস্তু. কাস্টম প্রশ্নের জন্য 200 অক্ষরের মধ্যে সীমিত।

responseOptions[]

object ( SurveyResponse )

প্রয়োজন। প্রশ্নের সাথে প্রদর্শিত উত্তরের তালিকা। সর্বোচ্চ 12।

টাইপ

জরিপ প্রশ্নের ধরন।

এনামস
TYPE_UNSPECIFIED অজানা সমীক্ষা প্রশ্নের ধরন।
GOOGLE_STANDARD_QUESTION গুগল স্ট্যান্ডার্ড সমীক্ষা প্রশ্ন।
GOOGLE_TEMPLATE_QUESTION গুগল টেমপ্লেট সার্ভে প্রশ্ন প্রদান করেছে।
PARTNER_CUSTOM_QUESTION অংশীদার কাস্টমাইজড জরিপ প্রশ্ন.

সার্ভে রেসপন্স

একটি সমীক্ষা প্রশ্নের উত্তরের জন্য সামগ্রী।

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

string

প্রয়োজন। টেক্সট যা সমীক্ষায় দেখানো হয় এবং ব্যবহারকারী এটি ট্যাপ করলে এজেন্টের কাছে ফেরত পাঠানো হয়। সর্বোচ্চ 35টি অক্ষর।

postbackData

string

ব্যবহারকারী প্রশ্নের উত্তর ট্যাপ করলে এজেন্ট যে স্ট্রিংটি পায়।

পদ্ধতি

create

একটি ব্র্যান্ডের প্রতিনিধিত্ব করার জন্য একটি নতুন এজেন্ট তৈরি করে।

delete

একটি এজেন্ট মুছে দেয়।

get

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

getLaunch

একটি এজেন্ট জন্য লঞ্চ তথ্য পায়.

getVerification

একটি এজেন্ট জন্য যাচাইকরণ তথ্য পায়.

list

একটি ব্র্যান্ডের সাথে যুক্ত সমস্ত এজেন্টদের তালিকা করুন।

patch

একটি এজেন্ট সম্পর্কে আপডেট তথ্য.

requestLaunch

একজন এজেন্টের জন্য লঞ্চ প্রক্রিয়া শুরু করে।

requestVerification

একজন এজেন্টের জন্য ব্যবসায়িক তথ্য যাচাইকরণ শুরু করে।

updateLaunch

একটি এজেন্টের জন্য লঞ্চ তথ্য আপডেট করে।

updateVerification

একটি এজেন্টের জন্য যাচাইকরণের অবস্থা আপডেট করে।