1. منتجات
  2.   جدول
  3.   Python
  4.   Pygsheets
 
  

مكتبة بايثون مفتوحة المصدر لجداول بيانات جوجل

تسمح واجهة برمجة تطبيقات Python بإنشاء جداول بيانات Google وتعديلها، وإضافة مجموعة جديدة من الخلايا أو الصفوف، وتطبيق التنسيق على مجموعة من الخلايا، وحماية جداول البيانات، وغير ذلك الكثير.

Pygsheets هي مكتبة Python بسيطة تمنح مطوري البرامج القدرة على إنشاء جداول بيانات Google والتعامل معها باستخدام أوامر Python. المكتبة مستقرة للغاية وتسهل على المطورين إنشاء جدول بيانات جديد وتعديل جدول بيانات موجود. فهو يساعد المطورين على التعامل مع معظم المهام المتعلقة بجداول البيانات باستخدام سطرين فقط من التعليمات البرمجية. الميزات المتقدمة مثل تطبيق التنسيق الشرطي على الخلايا أو الصفوف والحصول على القيمة مدعومة بالكامل ويسهل التعامل معها.

توفر مكتبة Pygsheets مجموعة من الميزات المتقدمة والأساسية للتعامل مع جداول بيانات Google، مثل إنشاء جداول البيانات أو تحريرها أو حذفها باستخدام عنوان أو مفتاح، أو إضافة ورقة عمل جديدة، أو إضافة مجموعة جديدة من الخلايا أو الصفوف، أو تطبيق التنسيق. إلى مجموعة من الخلايا، حماية جدول البيانات، ضبط تنسيق الخلية، تنسيق الرسائل النصية، تطبيق اللون على نطاق من الخلايا، إضافة ملاحظات إلى ورقة عمل، دعم النطاقات المسماة، دعم التحقق من صحة البيانات، استخدام مربعات الاختيار أو القوائم المنسدلة، الحصول على قيمة من خلية وتحديث قيمة الخلية وغير ذلك الكثير.

Previous Next

البدء باستخدام أوراق Pygsheets

تحتاج إلى تثبيت Python 2.7 أو 3.4+ أو إصدار أحدث على نظامك لتشغيل Pygsheets بسلاسة. الطريقة الموصى بها للتثبيت عبر PIP. الرجاء استخدام الأمر التالي.

قم بتثبيت Pygsheets عبر أمر PIP

pip install pygsheets

الطريقة الأخرى للتثبيت هي من GitHub. الرجاء استخدام الأمر التالي.

Install Pygsheets via GitHub

pip install https://github.com/nithinmurali/pygsheets/archive/staging.zip

إدارة ورقة العمل باستخدام Python API

تمكن مكتبة Pygsheets مفتوحة المصدر التطبيقات البرمجية من التعامل مع أوراق العمل داخل جداول بيانات Google الخاصة بها. لقد وفر العديد من الوظائف المهمة للتعامل مع أوراق العمل مثل إنشاء ورقة عمل جديدة، وإدراج خلايا في ورقة، وإعادة تسمية ورقة عمل، وتحديث محتوى ورقة العمل، والحصول على قيمة صف أو عمود معين، وتحديث نطاق من القيم باستخدام قائمة الخلايا أو المصفوفة، وإدراج صف جديد في المكان الذي تختاره، وتغيير حجم الصفوف أو الأعمدة، والمزيد.

تطبيق تنسيق مصنف Excel على الأعمدة عبر Python API

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 على مبرمجي البرامج الوصول إلى جدول بيانات وفتحه داخل تطبيقات Python الخاصة بهم. توفر المكتبة طرقًا متعددة لفتح جدول بيانات. يمكنك فتح جدول بيانات حسب عنوانه كما يظهر في مستندات Google باستخدام رمز خطي واحد فقط. يمكنك أيضًا فتح جدول بيانات عن طريق توفير مفتاح. من الممكن مشاركة جدول البيانات مع أعضاء الفريق الآخرين وإجراء تغييرات عليه حسب حاجتك.

فتح جدول بيانات وتعديله عبر 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 مفتوحة المصدر وظيفة لحماية ورقة عمل معينة من التغييرات غير المقصودة داخل تطبيقات Python الخاصة بها. لقد تضمن دعمًا لحماية ورقة العمل بأكملها أو نطاق معين من الخلايا والسماح للمستخدمين بإجراء تغييرات على معظم جدول البيانات وفقًا لمتطلباتهم.

كيفية حماية ورقة كاملة عبر Python API؟

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

r.protected = True # this will make the whole sheet protected
 عربي