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 کیلوبایت

پس از تأیید نمایندگی قابل تغییر نیست.

entryPointConfigs[]

object ( BusinessMessagesEntryPointConfig )

اختیاری. لیست تنظیمات نقطه ورودی

پس از تأیید نمایندگی قابل تغییر نیست.

conversationalSettings

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

مورد نیاز. تنظیمات مکالمه برای یک عامل، نگاشت به یک منطقه. Locale توسط یک برچسب زبان 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 )

فقط خروجی نشانی‌های اینترنتی برای آزمایش تجربه مکالمه نماینده.

توسط پلت فرم تعریف شده است.

phone

object ( Phone )

اختیاری. شماره تلفن نماینده برای نمایش. اگر مشخص نشده باشد، نماینده شماره تلفن نام تجاری موجود در نمودار دانش Google را در صورت وجود نشان می دهد.

authorizationConfig

object ( AuthorizationConfig )

اختیاری. پیکربندی مجوز برای پشتیبانی OAuth.

nonLocalConfig

object ( NonLocalConfig )

اختیاری. پیکربندی برای نقاط ورودی غیر محلی.

surveyConfig

object ( SurveyConfig )

اختیاری. پیکربندی برای فعال کردن نظرسنجی های سفارشی.

BusinessMessagesEntryPointConfig

پیکربندی نقطه ورودی برای یک عامل.

نمایندگی JSON 
{
  "allowedEntryPoint": enum (EntryPoint)
}
فیلدها
allowedEntryPoint

enum ( EntryPoint )

مورد نیاز. سطوح Google که عامل فعال است تا در آنها ظاهر شود.

EntryPoint

سطوح Google که عامل فعال است تا در آنها ظاهر شود.

Enums
ENTRY_POINT_UNSPECIFIED نقطه ورود نامشخص
LOCATION مکان‌ها را برای این نماینده فعال کنید.
NON_LOCAL پیام‌های تجاری را برای نقاط ورودی غیرمحلی فعال کنید.

SupportedAgentInteraction

تعاملات پشتیبانی شده توسط یک عامل.

نمایندگی 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 )

جزئیات نماینده انسانی

نوع تعامل

نوع تعامل پشتیبانی شده برای عامل.

Enums
INTERACTION_TYPE_UNSPECIFIED تعامل نامشخص
BOT تعامل با ربات
HUMAN تعامل انسانی.

BotRepresentative

جزئیات برای نماینده ربات.

نمایندگی JSON 
{
  "botMessagingAvailability": {
    object (MessagingAvailability)
  }
}
فیلدها
botMessagingAvailability

object ( MessagingAvailability )

مورد نیاز. در دسترس بودن پیام ربات.

MessagingAvailability

ساعات هر روز هفته که پیام رسانی در دسترس است. می توانید ساعت ها را برای چند روز با هم گروه بندی کنید. برای مثال، * 08:00-16:00 PDT دوشنبه تا چهارشنبه * 10:00-14:00 PDT پنجشنبه تا جمعه * 15:00-18:00 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 )

مورد نیاز. روز پایان. شامل روز مشخص شده است.

TimeOfDay

یک زمان از روز را نشان می دهد. تاریخ و منطقه زمانی یا مهم نیستند یا در جای دیگری مشخص شده اند. یک 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 باشد.

روز هفته

یک روز از هفته را نشان می دهد.

Enums
DAY_OF_WEEK_UNSPECIFIED روز هفته نامشخص است.
MONDAY دوشنبه
TUESDAY سه شنبه
WEDNESDAY چهارشنبه
THURSDAY پنج شنبه
FRIDAY جمعه
SATURDAY شنبه
SUNDAY یکشنبه

نماینده انسانی

جزئیات برای نماینده انسانی.

نمایندگی JSON 
{
  "humanMessagingAvailability": {
    object (MessagingAvailability)
  }
}
فیلدها
humanMessagingAvailability

object ( MessagingAvailability )

مورد نیاز. در دسترس بودن پیام های انسانی

AuthorizationConfig

جزئیات پیکربندی برای پشتیبانی از OAuth در پیام‌های تجاری.

نمایندگی JSON 
{
  "endpointUrl": string
}
فیلدها
endpointUrl

string

نشانی وب نقطه پایانی که کاربر در آن وارد می شود.

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

مورد نیاز. فهرست کدهای منطقه CLDR برای کشورهایی که نماینده مجاز است نقاط ورودی NON_LOCAL را راه‌اندازی کند. برای نقاط ورودی NON_LOCAL لازم است.

ContactOption

جزئیات تماس علاوه بر دکمه پیام‌رسانی نمایش داده می‌شود.

نمایندگی JSON 
{
  "url": string,
  "options": [
    enum (Option)
  ]
}
فیلدها
url

string

مورد نیاز. آدرس اینترنتی که گزینه های تماس برای آن در دسترس هستند.

options[]

enum ( Option )

مورد نیاز. لیست گزینه های تماس موجود برای URL مشخص شده.

گزینه

گزینه های تماس

Enums
OPTION_UNSPECIFIED نامشخص
WEB_CHAT گزینه چت وب
PHONE گزینه تلفن
EMAIL گزینه ایمیل
FAQS گزینه پرسش و پاسخ.
TWITTER گزینه توییتر
WHATSAPP گزینه واتساپ

SurveyConfig

جزئیات پیکربندی برای پشتیبانی از سوالات نظرسنجی سفارشی.

نمایندگی JSON 
{
  "templateQuestionIds": [
    string
  ],
  "customSurveys": {
    string: {
      object (CustomSurveyConfig)
    },
    ...
  }
}
فیلدها
templateQuestionIds[]

string

فهرست شناسه‌های سؤال الگو برای سؤالات الگو موجود در نظرسنجی.

customSurveys

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

سؤالات نظرسنجی سفارشی برای یک نماینده، نگاشت شده به یک منطقه. Locale توسط یک برچسب زبان IETF BCP 47 به خوبی شکل گرفته نشان داده می شود.

یک شی حاوی لیستی از "key": value . مثال: { "name": "wrench", "mass": "1.3kg", "count": "3" } .

CustomSurveyConfig

پیکربندی نظرسنجی سفارشی برای یک نماینده.

نمایندگی JSON 
{
  "customQuestions": [
    {
      object (SurveyQuestion)
    }
  ]
}
فیلدها
customQuestions[]

object ( SurveyQuestion )

لیست سوالات سفارشی

SurveyQuestion

محتوای دقیق هر سوال نظرسنجی.

نمایندگی JSON 
{
  "name": string,
  "questionType": enum (Type),
  "questionContent": string,
  "responseOptions": [
    {
      object (SurveyResponse)
    }
  ]
}
فیلدها
name

string

مورد نیاز. شناسه منحصر به فرد سوال

questionType

enum ( Type )

فقط خروجی نوع سوال

questionContent

string

مورد نیاز. محتوای سوال محدود به 200 کاراکتر برای سوالات سفارشی.

responseOptions[]

object ( SurveyResponse )

مورد نیاز. لیست پاسخ ها همراه با سوال نمایش داده می شود. حداکثر 12.

تایپ کنید

نوع سوال نظرسنجی

Enums
TYPE_UNSPECIFIED نوع سوال نظرسنجی نامشخص.
GOOGLE_STANDARD_QUESTION سوال استاندارد نظرسنجی گوگل
GOOGLE_TEMPLATE_QUESTION گوگل الگوی سوال نظرسنجی را ارائه کرد.
PARTNER_CUSTOM_QUESTION سوال نظرسنجی سفارشی شریک.

SurveyResponse

محتوای پاسخ به سوال نظرسنجی

نمایندگی JSON 
{
  "content": string,
  "postbackData": string
}
فیلدها
content

string

مورد نیاز. متنی که در نظرسنجی نشان داده می‌شود و وقتی کاربر روی آن ضربه می‌زند، برای نماینده ارسال می‌شود. حداکثر 35 کاراکتر

postbackData

string

رشته ای که عامل با ضربه زدن کاربر روی پاسخ سوال دریافت می کند.

روش ها

create

 یک عامل جدید برای نمایندگی یک برند ایجاد می کند.

delete

 یک عامل را حذف می کند.

get

 اطلاعاتی در مورد یک نماینده دریافت کنید.

getLaunch

 اطلاعات راه اندازی را برای یک نماینده دریافت می کند.

getVerification

 اطلاعات تأیید را برای یک نماینده دریافت می کند.

list

 تمام عوامل مرتبط با یک برند را فهرست می کند.

patch

 اطلاعات یک نماینده را به روز می کند.

requestLaunch

 فرآیند راه اندازی را برای یک نماینده آغاز می کند.

requestVerification

 تأیید اطلاعات کسب و کار را برای یک نماینده آغاز می کند.

updateLaunch

 اطلاعات راه اندازی را برای یک نماینده به روز می کند.

updateVerification

 وضعیت تأیید را برای یک نماینده به روز می کند.