با مجموعه‌ها، منظم بمانید ذخیره و طبقه‌بندی محتوا براساس اولویت‌های شما.
Google Sheets API یک رابط RESTful است که به شما امکان می‌دهد داده‌های صفحه‌گسترده را بخوانید و تغییر دهید. API Sheets به شما امکان می دهد:
صفحات گسترده ایجاد کنید
خواندن و نوشتن مقادیر سلول های صفحه گسترده
قالب بندی صفحه گسترده را به روز کنید
صفحات متصل را مدیریت کنید
در زیر لیستی از اصطلاحات رایج مورد استفاده در Sheets API آمده است:
صفحه گسترده
شی اصلی در Google Sheets. می تواند حاوی چندین Sheets باشد که هر کدام دارای اطلاعات ساختار یافته در Cells هستند. منبع spreadsheets یک صفحه گسترده را نشان می دهد. حاوی یک مقدار spreadsheetId منحصر به فرد است.
شناسه صفحه گسترده
شناسه منحصر به فرد برای یک صفحه گسترده. این یک رشته خاص است که شامل حروف، اعداد و برخی از کاراکترهای خاص است که به صفحه‌گسترده اشاره می‌کند و می‌توان آن را از URL صفحه‌گسترده مشتق کرد. شناسه‌های صفحه‌گسترده پایدار هستند، حتی اگر نام صفحه‌گسترده تغییر کند.
یک صفحه یا برگه در یک صفحه گسترده. منبع Sheets یک برگه را نشان می دهد. این شامل یک مقدار sheetId عددی و title برگه به عنوان بخشی از شی SheetProperties است.
شناسه برگه
شناسه منحصر به فرد برای یک صفحه خاص در یک صفحه گسترده. این یک عدد صحیح خاص حاوی اعدادی است که به یک صفحه ارجاع می دهند و می توان آن را از URL صفحه گسترده مشتق کرد. شناسه‌های برگه ثابت هستند، حتی اگر نام برگه تغییر کند. برای مثال، شناسه صفحه گسترده را ببینید.
سلول
یک فیلد جداگانه از متن یا داده در یک برگه. سلول ها در ردیف ها و ستون ها مرتب شده اند و می توانند به عنوان یک محدوده از سلول ها گروه بندی شوند. منبع Cells هر سلول را نشان می دهد، اما یک مقدار ID منحصر به فرد ندارد. در عوض، مختصات سطر و ستون سلول ها را مشخص می کند.
نماد A1
نحوی که برای تعریف سلول یا محدوده ای از سلول ها با رشته ای استفاده می شود که شامل نام برگه به اضافه مختصات سلول شروع و پایان با استفاده از حروف ستون و شماره ردیف است. این روش رایج ترین و مفیدترین روش برای ارجاع به محدوده مطلق سلول ها است.
Sheet1!A1:B2 به تمام سلول های دو سطر و ستون اول Sheet1 اشاره دارد.
Sheet1!A:A به تمام سلول های ستون اول Sheet1 اشاره دارد.
Sheet1!1:2 به تمام سلول های دو ردیف اول Sheet1 اشاره دارد.
Sheet1!A5:A به تمام سلول های ستون اول Sheet 1، از ردیف 5 به بعد اشاره دارد.
A1:B2 به تمام سلول های دو سطر و ستون اول اولین صفحه قابل مشاهده اشاره دارد.
Sheet1 به تمام سلول های Sheet1 اشاره دارد.
'Jon's_Data'!A1:D5 به تمام سلول های پنج سطر و چهار ستون اول یک برگه با نام "Jon's_Data" اشاره دارد.
'My Custom Sheet'!A:A به تمام سلول های ستون اول یک برگه به نام "برگ سفارشی من" اشاره دارد.
'My Custom Sheet' به تمام سلول های "برگ سفارشی من" اشاره دارد.
برای نام‌های برگه با فاصله یا نویسه‌های خاص، نقل‌قول‌های تکی لازم است.
نکته : در صورت امکان، از نام‌های متمایز برای اشیاء در صفحات گسترده خود استفاده کنید. به عنوان مثال، A1 (بدون نقل قول) به سلول A1 در اولین صفحه قابل مشاهده اشاره دارد. 'A1' به برگه ای با نام A1 اشاره دارد. به طور مشابه، Sheet1 به برگه ای با نام Sheet1 اشاره دارد. با این حال، اگر محدوده ای با نام با عنوان "Sheet1" وجود داشته باشد، Sheet1 به محدوده نامگذاری شده و 'Sheet1' به صفحه اشاره دارد.
نماد R1C1
نحوی که برای تعریف سلول یا محدوده ای از سلول ها با رشته ای استفاده می شود که شامل نام برگه به اضافه مختصات سلول های شروع و پایان با استفاده از شماره ردیف و شماره ستون است. این روش کمتر از نماد A1 رایج است، اما می تواند هنگام ارجاع به محدوده ای از سلول ها نسبت به موقعیت یک سلول معین مفید باشد.
Sheet1!R1C1:R2C2 به دو سلول اول در دو ردیف بالای Sheet1 اشاره دارد.
R1C1:R2C2 به دو سلول اول در دو ردیف بالای اولین صفحه قابل مشاهده اشاره دارد.
Sheet1!R[3]C[1] به سلولی اشاره دارد که سه ردیف زیر و یک ستون در سمت راست سلول فعلی قرار دارد.
محدوده نامگذاری شده
یک سلول یا محدوده ای از سلول های تعریف شده با یک نام سفارشی برای ساده سازی مراجع در سراسر یک برنامه. یک منبع FilterView یک محدوده نامگذاری شده را نشان می دهد.
محدوده حفاظت شده
یک سلول تعریف شده یا محدوده ای از سلول ها که قابل تغییر نیستند. یک منبع ProtectedRange یک محدوده محافظت شده را نشان می دهد.
موضوعات مرتبط
برای آشنایی با توسعه با Google Workspace APIها، از جمله رسیدگی به احراز هویت و مجوز، به Develop on Google Workspace مراجعه کنید.
تاریخ آخرین بهروزرسانی 2025-08-04 بهوقت ساعت هماهنگ جهانی.
[[["درک آسان","easyToUnderstand","thumb-up"],["مشکلم را برطرف کرد","solvedMyProblem","thumb-up"],["غیره","otherUp","thumb-up"]],[["اطلاعاتی که نیاز دارم وجود ندارد","missingTheInformationINeed","thumb-down"],["بیشازحد پیچیده/ مراحل بسیار زیاد","tooComplicatedTooManySteps","thumb-down"],["قدیمی","outOfDate","thumb-down"],["مشکل ترجمه","translationIssue","thumb-down"],["مشکل کد / نمونهها","samplesCodeIssue","thumb-down"],["غیره","otherDown","thumb-down"]],["تاریخ آخرین بهروزرسانی 2025-08-04 بهوقت ساعت هماهنگ جهانی."],[],[],null,["The Google Sheets API is a RESTful interface that lets you read and modify a\nspreadsheet's data. The Sheets API lets you:\n\n- Create spreadsheets\n- Read and write spreadsheet cell values\n- Update spreadsheet formatting\n- Manage Connected Sheets\n\nThe following is a list of common terms used in the Sheets API:\n\n*Spreadsheet*\n\n: The primary object in Google Sheets. It can contain multiple `Sheets`, each\n with structured information contained in `Cells`. The\n [`spreadsheets`](/workspace/sheets/api/reference/rest/v4/spreadsheets)\n resource represents a spreadsheet. It contains a unique `spreadsheetId`\n value.\n\n *Spreadsheet ID*\n : The unique identifier for a spreadsheet. It's a particular string\n containing letters, numbers, and some special characters that reference a\n spreadsheet and it can be derived from the spreadsheet's URL. Spreadsheet\n IDs are stable, even if the spreadsheet name changes. \n\n https://docs.google.com/spreadsheets/d/\u003cvar translate=\"no\"\u003eSPREADSHEET_ID\u003c/var\u003e/edit?gid=\u003cvar translate=\"no\"\u003eSHEET_ID\u003c/var\u003e#gid=\u003cvar translate=\"no\"\u003eSHEET_ID\u003c/var\u003e\n\n*Sheet*\n\n: A page or tab within a spreadsheet. The\n [`Sheets`](/workspace/sheets/api/reference/rest/v4/spreadsheets/sheets) resource\n represents a sheet. It contains a unique numeric `sheetId` value and sheet\n `title` as part of the\n [`SheetProperties`](/workspace/sheets/api/reference/rest/v4/spreadsheets/sheets#sheetproperties)\n object.\n\n *Sheet ID*\n : The unique identifier for a specific sheet within a spreadsheet. It's a\n particular integer containing numbers that reference a sheet and it can be\n derived from the spreadsheet's URL. Sheet IDs are stable, even if the sheet\n name changes. For an example, see [Spreadsheet ID](#spreadsheet-id).\n\n*Cell*\n\n: An individual field of text or data within a sheet. Cells are arranged in rows\n and columns, and can be grouped as a range of cells. The\n [`Cells`](/workspace/sheets/api/reference/rest/v4/spreadsheets/cells)\n resource represents each cell, but it doesn't have a unique ID value.\n Instead, row and column coordinates identify the cells.\n\n *A1 notation*\n : A syntax used to define a cell or range of cells with a string that\n contains the sheet name plus the starting and ending cell coordinates using\n column letters and row numbers. This method is the most common and useful\n when referencing an absolute range of cells.\n - `Sheet1!A1:B2` refers to all the cells in the first two rows and columns of Sheet1.\n - `Sheet1!A:A` refers to all the cells in the first column of Sheet1.\n - `Sheet1!1:2` refers to all the cells in the first two rows of Sheet1.\n - `Sheet1!A5:A` refers to all the cells of the first column of Sheet 1, from row 5 onward.\n - `A1:B2` refers to all the cells in the first two rows and columns of the first visible sheet.\n - `Sheet1` refers to all the cells in Sheet1.\n - `'Jon's_Data'!A1:D5` refers to all the cells in the first five rows and four columns of a sheet named \"Jon's_Data.\"\n - `'My Custom Sheet'!A:A` refers to all the cells in the first column of a sheet named \"My Custom Sheet.\"\n - `'My Custom Sheet'` refers to all the cells in \"My Custom Sheet\".\n\n Single quotes are required for sheet names with spaces or special characters.\n\n **Tip** : Where possible, use distinct names for objects in your spreadsheets. For example, A1 (without quotes) refers to cell A1 in the first visible sheet. `'A1'` refers to a sheet with the name A1. Similarly, Sheet1 refers to a sheet with the name Sheet1. However, if there's a named range titled \"Sheet1\", then Sheet1 refers to the named range and `'Sheet1'` refers to the sheet.\n\n *R1C1 notation*\n : A syntax used to define a cell or range of cells with a string that\n contains the sheet name plus the starting and ending cell coordinates using\n row numbers and column numbers. This method is less common than A1 notation,\n but can be useful when referencing a range of cells relative to a given\n cell's position.\n - `Sheet1!R1C1:R2C2` refers to the first two cells in the top two rows of Sheet1.\n - `R1C1:R2C2` refers to the first two cells in the top two rows of the first visible sheet.\n - `Sheet1!R[3]C[1]` refers to the cell that is three rows below and one column to the right of the current cell.\n\n *Named range*\n : A defined cell or range of cells with a custom name to simplify references\n throughout an application. A\n [`FilterView`](/workspace/sheets/api/reference/rest/v4/spreadsheets/sheets#filterview)\n resource represents a named range.\n\n *Protected range*\n : A defined cell or range of cells that cannot be modified. A\n [`ProtectedRange`](/workspace/sheets/api/reference/rest/v4/spreadsheets/sheets#protectedrange)\n resource represents a protected range.\n\nRelated topics\n\n- To learn about developing with Google Workspace APIs, including handling\n authentication and authorization, refer to [Develop on\n Google Workspace](/workspace/guides/get-started).\n\n- To learn how to configure and run a Sheets API app, try the\n [JavaScript quickstart](/workspace/sheets/api/quickstart/js)."]]
