منبع مانیفست ویرایشگر

پیکربندی منبعی که برای تعریف محتوا و رفتار افزونه Google Workspace در ویرایشگرها استفاده می‌شود. اگر مانیفست‌های افزودنی Google Workspace ویرایشگر را گسترش دهند، باید همه مؤلفه‌ها به‌عنوان مورد نیاز علامت‌گذاری شوند.

ویراستاران

پیکربندی مانیفست افزونه Google Workspace برای برنامه‌های افزودنی ویرایشگر. برای اطلاعات بیشتر به گسترش ویرایشگرها با افزونه‌های Google Workspace مراجعه کنید.

نمایندگی JSON
  {
    "homepageTrigger": {
      object (HomepageTrigger)
    },
    "onFileScopeGrantedTrigger": {
      object (OnFileScopeGrantedTrigger)
    },
    "linkPreviewTriggers": [
      {
        object (LinkPreviewTriggers)
      }
    ],
    "createActionTriggers": [
      {
        object (CreateActionTriggers)
      }
  }
زمینه های
homepageTrigger

object ( HomepageTrigger )

این تابع ماشه صفحه اصلی افزونه را در برنامه میزبان ایجاد می کند. این addOns.common.homepageTrigger را لغو می کند.

onFileScopeGrantedTrigger

object ( OnFileScopeGrantedTrigger )

اگر برافزای شما شامل رفتاری خاص برای سند ویرایشگر فعلی باشد، زمانی که کاربر محدوده drive.file را مجاز می‌کند، فعال می‌شود.

linkPreviewTriggers[]

object ( LinkPreviewTriggers )

برای پیش نمایش پیوندها لازم است. فهرستی از محرک‌ها برای پیش‌نمایش پیوندها در فایل Google Docs، Sheets یا Slides. برای جزئیات، به پیش‌نمایش پیوندها با تراشه‌های هوشمند مراجعه کنید.

createActionTriggers[]

object ( createActionTriggers )

برای ایجاد منبع شخص ثالث مورد نیاز است. فهرستی از محرک‌ها برای ایجاد منابع در یک سرویس شخص ثالث از منوی @. برای جزئیات، به ایجاد منابع شخص ثالث با تراشه‌های هوشمند مراجعه کنید.

OnFileScopeGrantedTrigger

پیکربندی برای یک تریگر متنی که هنگام گفتگوی دامنه فایل درخواست با استفاده از CardService.newEditorFileScopeActionResponseBuilder() .requestFileScopeForActiveDocument().build(); و کاربر مجوز دامنه drive.file را اعطا می کند.

نمایندگی JSON
{
  "runFunction": string
}
زمینه های
runFunction

string

نام تابعی که در صورت اعطای دامنه drive.file اجرا می شود. اگر مشخص شده است، باید این تابع را برای ایجاد و بازگرداندن آرایه ای از اشیاء Card برای نمایش در رابط کاربری افزونه پیاده سازی کنید.

LinkPreview Triggers

پیکربندی یک راه‌انداز که زمانی فعال می‌شود که کاربر پیوندی را از یک سرویس شخص ثالث یا غیر Google در فایل اسناد، کاربرگ‌نگار یا اسلایدنگار تایپ یا جای‌گذاری کند.

برای راه‌اندازی این راه‌انداز برای افزونه Google Workspace، به پیش‌نمایش پیوندها با تراشه‌های هوشمند مراجعه کنید.

نمایندگی JSON
{
  "labelText": string,
  "localizedLabelText": {
    string: string,
    ...
  },
  "runFunction": string,
  "logoUrl": string,
  "patterns": [
    {
      object(patterns)
    }
  ]
}
زمینه های
labelText

string

ضروری. متن یک نمونه تراشه هوشمند که از کاربران می خواهد پیوند را پیش نمایش کنند، مانند Example: Support case . این متن ثابت است و قبل از اجرای افزونه توسط کاربران نمایش داده می شود.
localizedLabelText

map (key: string, value: string)

اختیاری. نقشه labelText برای بومی سازی به زبان های دیگر. زبان را در ISO 639 و کشور/منطقه را در ISO 3166 فرمت کنید که با خط فاصله جدا شده اند - . به عنوان مثال، en-US .

اگر محلی کاربر در کلیدهای نقشه وجود داشته باشد، کاربر نسخه محلی labelText را می بیند.

patterns[]

object ( UriPattern )

ضروری. مجموعه ای از الگوهای URL که افزونه را برای پیش نمایش پیوندها فعال می کند.
runFunction

string

ضروری. نام تابعی که زمانی که کاربر محدوده https://www.googleapis.com/auth/workspace.linkpreview را مجاز می کند اجرا شود. اگر مشخص شده باشد، باید این تابع را پیاده سازی کنید تا یک شی رویداد حاوی EDITOR_NAME .matchedUrl.url را به عنوان آرگومان بپذیرید و یک شی Card واحد را که پیش نمایش پیوند را در رابط کاربری افزونه نمایش می دهد، برگردانید.
logoUrl

string

اختیاری. نمادی که در تراشه هوشمند و کارت پیش نمایش نمایش داده می شود. اگر حذف شود، افزونه از نماد نوار ابزار خود، logoUrl استفاده می کند.

UriPattern

پیکربندی برای هر الگوی URL که پیش‌نمایش پیوند را راه‌اندازی می‌کند.

نمایندگی JSON
{
  "hostPattern": string,
  "pathPrefix" : string
}
زمینه های
hostPattern

string

برای پیش نمایش برای هر الگوی URL مورد نیاز است. دامنه الگوی URL. افزونه پیوندهای حاوی این دامنه را در URL پیش‌نمایش می‌کند. برای پیش‌نمایش پیوندها برای یک زیردامنه خاص، مانند subdomain.example.com ، زیر دامنه را اضافه کنید. برای پیش نمایش پیوندها برای کل دامنه، یک کاراکتر عام با ستاره ( * ) به عنوان زیر دامنه مشخص کنید.

برای مثال، *.example.com با subdomain.example.com و another.subdomain.example.com مطابقت دارد.

pathPrefix

string

اختیاری. مسیری که دامنه hostPattern را اضافه می کند.

به عنوان مثال، اگر الگوی میزبان URL support.example.com باشد، برای مطابقت با نشانی‌های وب برای موارد میزبانی شده در support.example.com/cases/ ، از cases استفاده کنید.

برای مطابقت با همه URL ها در دامنه الگوی میزبان، pathPrefix را خالی بگذارید.

CreateActionTriggers

پیکربندی یک ماشه که وقتی کاربر یک مورد منوی یکپارچه‌سازی شخص ثالث را از منوی Google Docs @ انتخاب می‌کند فعال می‌شود.

برای راه‌اندازی این راه‌انداز برای افزونه Google Workspace، به ایجاد منابع شخص ثالث با تراشه‌های هوشمند مراجعه کنید.

نمایندگی JSON
{
  "id": string,
  "labelText": string,
  "localizedLabelText": {
    string: string,
    ...
  },
  "runFunction": string,
  "logoUrl": string,
}
زمینه های
id

string

ضروری. شناسه منحصر به فرد برای متمایز کردن این نقطه پسوند. شناسه می تواند حداکثر 64 کاراکتر داشته باشد و باید در قالب [a-zA-Z0-9-]+. .
labelText

string

ضروری. متنی که در منوی @ ظاهر می‌شود، مانند Create support case .
localizedLabelText

map (key: string, value: string)

اختیاری. نقشه labelText برای بومی سازی به زبان های دیگر. زبان را در ISO 639 و کشور/منطقه را در ISO 3166 فرمت کنید که با خط فاصله جدا شده اند - . به عنوان مثال، en-US .

اگر محلی کاربر در کلیدهای نقشه وجود داشته باشد، کاربر نسخه محلی labelText را می بیند.

runFunction

string

ضروری. نام تابعی که وقتی کاربر یک نقطه افزونه را از منوی @ انتخاب می‌کند اجرا شود. تابع باید یک کارت فرم با ورودی برای ایجاد منبع شخص ثالث برگرداند.
logoUrl

string

اختیاری. نمادی که در منوی @ نمایش داده می شود. اگر حذف شود، افزونه از نماد نوار ابزار خود، logoUrl استفاده می کند.