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 که عامل فعال است تا در آنها ظاهر شود.

نقطه ورود

سطوح 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

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