تراشه های هوشمند

این راهنما نحوه و چرایی استفاده از Google Sheets API برای افزودن و مدیریت تراشه‌های هوشمند در صفحات گسترده را توضیح می‌دهد.

چیپ هوشمند چیست؟

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

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

تراشه‌ها به‌عنوان اجرای تراشه‌ها نشان داده می‌شوند که بخشی از CellData هستند، بنابراین می‌توانید یک تراشه را با استفاده از روش spreadsheets.batchUpdate موجود با ارائه UpdateCellsRequest یا AppendCellsRequest وارد کنید.

درخواست باید شامل قسمت chipRuns باشد. اجرای تراشه ویژگی‌های تراشه و محل قرارگیری آن در متن سلول را توصیف می‌کند.

هنگام نوشتن chipRuns ، باید یک userEnteredValue که حاوی کاراکترهای متغیر ( @ ) برای هر تراشه ای که قصد اضافه کردن آن را دارید ارائه دهید. هر اجرا در آرایه chipRuns مربوط به یکی از متغیرها خواهد بود. اجراهای بدون تراشه را می توان در نوشتن حذف کرد.

مثال زیر نحوه نوشتن یک تراشه فایل، یک تراشه افراد و متن ساده را در یک سلول واحد A1 نشان می دهد. * {JSON}

        {
          "updateCells": {
            "rows": [
              {
                "values": [
                  {
                    "userEnteredValue": {
                      "stringValue": "@ is the owner of @."
                    },
                    "chipRuns": [
                      {
                        "chip": {
                          "personProperties": {
                            "email": "johndoe@gmail.com",
                            "displayFormat": "DEFAULT"
                          }
                        }
                      },
                      {
                        "startIndex": 18,
                        "chip": {
                          "richLinkProperties": {
                            "uri": "https://docs.google.com/document/d/YOUR_DOCUMENT_ID/edit"
                          }
                        }
                      }
                    ]
                  }
                ]
              }
            ],
            "fields": "userEnteredValue,chipRuns",
            "range": {
              "startRowIndex": 0,
              "startColumnIndex": 0
            }
          }
        }

پیکربندی ویژگی های تراشه

یک شی تراشه می تواند یکی از انواع ویژگی های زیر را داشته باشد:

خصوصیات شخص

از این برای ایجاد یک تراشه شخص استفاده کنید.

  • email : (الزامی) آدرس ایمیل شخصی که باید پیوند داده شود.
  • displayFormat : (اختیاری) قالب نمایش ترجیحی برای نام شخص. می تواند یکی از موارد زیر باشد:
    • DEFAULT : قالب استاندارد "نام و نام خانوادگی".
    • LAST_NAME_COMMA_FIRST_NAME : قالب "نام خانوادگی، نام".
    • EMAIL : آدرس ایمیل شخص.

از این برای ایجاد یک تراشه پیوند غنی استفاده کنید. در حالی که API می‌تواند پیوندهای سرویس‌های مختلف Google (مانند YouTube یا تقویم) را بخواند، فقط پیوندهای فایل‌های Google Drive را می‌توان به صورت تراشه نوشت.

  • uri : (الزامی) URI منبع. برای نوشتن، این باید یک پیوند فایل Google Drive باشد. URI ها نمی توانند از 2000 بایت تجاوز کنند.

تراشه هوشمند را بخوانید

برای خواندن داده های تراشه هوشمند، از روش spreadsheets.get استفاده کنید و sheets.data.rowData.values(chipRuns) در پارامتر فیلدها قرار دهید.

آرایه chipRuns در پاسخ حاوی اشیایی برای تمام زیربخش‌های متن سلول است.

  • اجراهای تراشه شده: این بخش ها دارای یک شی chip پر شده شامل personProperties یا richLinkProperties هستند.
  • اجراهای بدون تراشه: بخش‌های متن ساده نیز یک شی اجرا دارند، اما فیلد chip آن خالی خواهد بود.

برای دریافت متن نمایشگر یک تراشه، formattedValue به عنوان یک فیلد اضافه کنید.

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

برای به روز رسانی یا جایگزینی تراشه هوشمند، باید محتویات سلول را بازنویسی کنید. از همان UpdateCellsRequest یا AppendCellsRequest استفاده کنید که برای افزودن یک تراشه، ارائه userEnteredValue و chipRun جدید. این جایگزین تراشه موجود در سلول خواهد شد.

از تراشه های هوشمند با سایر ویژگی های Sheets استفاده کنید

جداول : تراشه های هوشمند را می توان به عنوان یک نوع ستون جدول برای ردیابی صاحبان پروژه (تراشه افراد) یا اسناد مرتبط (تراشه فایل) استفاده کرد.

فیلترها : می‌توانید محدوده‌ها را بر اساس مقدار متن تراشه‌های هوشمند درون آن‌ها فیلتر کنید.