Open Source Python API for Google Sheets

الشروع في العمل مع Gspread

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

 pip install gspread 

قم بإنشاء جدول بيانات ومشاركته عبر مكتبة Python

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

 sh = gc.create('A new spreadsheet')
# Add a new worksheet to the list of current sheets
try:
        sheet = spreadsheet.worksheet(tab_label)
    except gspread.exceptions.WorksheetNotFound:
        spreadsheet.add_worksheet( tab_label, 1, len(col_defs) )
        sheet = spreadsheet.worksheet( tab_label )

فتح جدول البيانات عبر بايثون

تتيح مكتبة جداول البيانات مفتوحة المصدر Gspread لمطوري البرامج تحويل ملفات CSV إلى تنسيق ملف Excel 2003 XML ببضعة سطور من التعليمات البرمجية. بادئ ذي بدء ، تحتاج إلى تحميل ملف CSV من الخادم لتحليله ونقل البيانات من المحلل اللغوي إلى الكاتب وتغيير نوع الكاتب إلى XML. بعد ذلك احفظ الملف بالاسم المحدد والهدف المحدد.

# You can open a spreadsheet by its title as it appears in Google Docs
sh = gc.open('My poor gym results') # <-- Look ma, no keys!
# If you want to be specific, use a key (which can be extracted from the spreadsheet's url)
sht1 = gc.open_by_key('0BmgG6nO_6dprdS1MN3d3MkdPa142WFRrdnRRUWl1UFE')
# Or, if you feel really lazy to extract that key, paste the entire url
sht2 = gc.open_by_url('https://docs.google.com/spreadsheet/ccc?key=0Bm...FE&hl')

تحليل ملف Excel 2003 XML

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

العمل مع خلايا جدول البيانات والصفوف

من الشائع جدًا نسخ البيانات من خلية واحدة أو أكثر من خلايا ورقة العمل إلى خلايا أخرى. يوفر Gspread API دعمًا كاملاً لمعالجة بيانات الخلية. يمكنك بسهولة الحصول على قيمة من خلية أو من صفوف وأعمدة جدول البيانات. توفر API أيضًا ميزات الحصول على جميع القيم من ورقة العمل كقائمة من القوائم. يمكنك أيضًا البحث عن خلية ذات قيمة دقيقة وكذلك البحث عن خلية مكافئة بتعبير عادي.

# Set text format to bold:
worksheet.format('A1:B1', {'textFormat': {'bold': True}})
# Color the background of a Cell range in black
# change horizontal alignment, text color and font size
worksheet.format("A2:B2", {
    "backgroundColor": {
      "red": 0.0,
      "green": 0.0,
      "blue": 0.0
    },
    "horizontalAlignment": "CENTER",
    "textFormat": {
      "foregroundColor": {
        "red": 1.0,
        "green": 1.0,
        "blue": 1.0
      },
      "fontSize": 12,
      "bold": True
    }
})