کتابخانه پایتون منبع باز برای صفحات گسترده گوگل

Python API امکان ایجاد و اصلاح صفحات گسترده گوگل، افزودن مجموعه جدیدی از سلول ها یا ردیف ها، اعمال قالب بندی به مجموعه ای از سلول ها، محافظت از صفحه گسترده و بسیاری موارد دیگر را می دهد.

Pygsheets یک کتابخانه ساده پایتون است که به توسعه دهندگان نرم افزار توانایی ایجاد و مدیریت صفحات گسترده گوگل را با استفاده از دستورات پایتون می دهد. این کتابخانه بسیار پایدار است و ایجاد یک صفحه گسترده جدید و اصلاح صفحه گسترده را برای توسعه دهندگان آسان می کند. این به توسعه دهندگان کمک می کند تا بیشتر وظایف مربوط به صفحه گسترده را تنها با چند خط کد انجام دهند. ویژگی‌های پیشرفته مانند اعمال قالب‌بندی شرطی در سلول‌ها یا ردیف‌ها و دریافت مقدار کاملاً پشتیبانی می‌شوند و کار با آن آسان است.

کتابخانه Pygsheets مجموعه‌ای از ویژگی‌های پیشرفته و همچنین پایه را برای مدیریت صفحات گسترده Google ارائه کرده است، مانند ایجاد، ویرایش یا حذف صفحات گسترده با استفاده از عنوان یا کلید، افزودن کاربرگ جدید، افزودن مجموعه جدیدی از سلول‌ها یا ردیف‌ها، اعمال قالب‌بندی به مجموعه‌ای از سلول‌ها، حفاظت از صفحه‌گسترده، تنظیم قالب سلول، قالب ارسال پیامک، اعمال رنگ به محدوده‌ای از سلول‌ها، افزودن یادداشت‌ها به کاربرگ، پشتیبانی از محدوده‌های نام‌گذاری شده، پشتیبانی از اعتبارسنجی داده‌ها، استفاده از جعبه‌های انتخاب یا کشویی، دریافت مقدار از یک سلول ، به روز رسانی یک مقدار سلول و موارد دیگر.

Previous Next

آغاز با Pygsheets

برای اجرای روان Pygsheets باید پایتون 2.7 یا 3.4+ یا بالاتر را روی سیستم خود نصب کنید. روش توصیه شده برای نصب از طریق PIP. لطفا از دستور زیر استفاده کنید.

Pygsheets را از طریق دستور PIP نصب کنید

pip install pygsheets

راه دیگر نصب از GitHub است. لطفا از دستور زیر استفاده کنید.

Pygsheets را از طریق GitHub

نصب کنید
نصب پیپ https://github.com/nithinmurali/pygsheets/archive/staging.zip

کاربرگ را با استفاده از Python API مدیریت کنید

کتابخانه منبع باز Pygsheets برنامه‌های نرم‌افزاری را قادر می‌سازد تا کاربرگ‌ها را در صفحه‌گسترده Google خود مدیریت کنند. چندین عملکرد مهم برای مدیریت کاربرگ‌ها ارائه کرده است، مانند ایجاد یک کاربرگ جدید، درج سلول‌ها در یک صفحه، تغییر نام یک کاربرگ، به‌روزرسانی محتوای یک کاربرگ، دریافت مقدار یک سطر یا ستون خاص، به‌روزرسانی محدوده‌ای از مقادیر با لیست یا ماتریس سلولی، یک ردیف جدید در محل مورد نظر خود وارد کنید، اندازه سطرها یا ستون ها را تغییر دهید و موارد دیگر.

از طریق Python API قالب‌بندی کتاب کار Excel را به ستون‌ها اعمال کنید

model_cell = pygsheets.Cell("A1")

model_cell.set_number_format(
    format_type = pygsheets.FormatType.PERCENT,
    pattern = "0%"
)
# first apply the percentage formatting
pygsheets.DataRange(
    left_corner_cell , right_corner_cell , worksheet = wks
 ).apply_format(model_cell)

# now apply the row-colouring interchangeably
gray_cell = pygsheets.Cell("A1")
gray_cell.color = (0.9529412, 0.9529412, 0.9529412, 0)

white_cell = pygsheets.Cell("A2")
white_cell.color = (1, 1, 1, 0)

cells = [gray_cell, white_cell]

for r in range(start_row, end_row + 1):
    print(f"Doing row {r} ...", flush = True, end = "\r")
    wks.get_row(r, returnas = "range").apply_format(cells[ r % 2 ], fields = "userEnteredFormat.backgroundColor")

یک صفحه گسترده را باز و ویرایش کنید

کتابخانه Pygsheets دسترسی برنامه نویسان نرم افزار و باز کردن صفحه گسترده در برنامه های پایتون خود را آسان می کند. کتابخانه راه های متعددی برای باز کردن صفحه گسترده ارائه کرده است. می‌توانید یک صفحه‌گسترده را با عنوان آن که در Google Docs ظاهر می‌شود، تنها با یک کد خطی باز کنید. همچنین می توانید با ارائه یک کلید صفحه گسترده را باز کنید. این امکان وجود دارد که صفحه گسترده را با سایر اعضای تیم به اشتراک بگذارید و براساس نیاز خود تغییراتی در آن ایجاد کنید.

باز کردن و اصلاح یک صفحه گسترده از طریق Python API

import pygsheets
import numpy as np

gc = pygsheets.authorize()

# Open spreadsheet and then worksheet
sh = gc.open('my new sheet')
wks = sh.sheet1

# Update a cell with value (just to let him know values is updated ;) )
wks.update_value('A1', "Hey yank this numpy array")
my_nparray = np.random.randint(10, size=(3, 4))

# update the sheet with array
wks.update_values('A2', my_nparray.tolist())

# share the sheet with your friend
sh.share("myFriend@gmail.com")

محافظت از کاربرگ از طریق پایتون

کتابخانه منبع باز Pygsheets عملکردی را برای محافظت از یک کاربرگ خاص در برابر تغییرات ناخواسته در برنامه های پایتون خود ارائه کرده است. این شامل پشتیبانی برای محافظت از کل کاربرگ یا محدوده خاصی از سلول‌ها می‌شود و به کاربران اجازه می‌دهد تا بر اساس نیاز خود در بیشتر صفحه‌گسترده تغییرات ایجاد کنند.

چگونه از یک صفحه کامل از طریق API Python محافظت کنیم؟

r = Datarange(worksheet=wks)
r # this is a datarange unbounded on both indexes

r.protected = True # this will make the whole sheet protected
 فارسی