تمت ترجمة هذه الصفحة بواسطة Cloud Translation API‏.

Events: get

لعرض حدث استنادًا إلى معرّف "تقويم Google" المتعلق به. لاسترداد حدث باستخدام معرّف iالتقويم، يمكنك استدعاء طريقة events.list باستخدام المَعلمة iCalUID. جرِّبه الآن أو شاهد مثالاً.

الطلب

طلب HTTP

GET https://www.googleapis.com/calendar/v3/calendars/calendarId/events/eventId

المَعلمات

اسم المعلَمة	القيمة	الوصف
مَعلمات المسار
`calendarId`	`string`	معرِّف التقويم. لاسترداد معرّفات التقويم، يمكنك استدعاء الطريقة calendarList.list. إذا كنت تريد الوصول إلى التقويم الأساسي للمستخدم المسجّل دخوله حاليًا، استخدِم الكلمة الرئيسية "`primary`".
`eventId`	`string`	معرّف الحدث
مَعلمات طلب البحث الاختيارية
`alwaysIncludeEmail`	`boolean`	تم التجاهل وتم تجاهله. سيتم دائمًا عرض قيمة في الحقل `email` للمنظِّم وصانع المحتوى والحاضرين، حتى في حال عدم توفّر عنوان بريد إلكتروني حقيقي (أي سيتمّ تقديم قيمة غير صالحة ومُنشأة).
`maxAttendees`	`integer`	تمثّل هذه السمة الحد الأقصى لعدد الضيوف الذين سيتم تضمينهم في الرد. إذا كان هناك أكثر من العدد المحدّد من الضيوف، يتم عرض المشارك فقط. اختياريّ.
`timeZone`	`string`	المنطقة الزمنية المستخدَمة في الردّ. اختياريّ. وتكون المنطقة الزمنية التلقائية هي المنطقة الزمنية للتقويم.

التفويض

يسمح هذا الطلب بالتفويض باستخدام نطاق واحد على الأقل من النطاقات التالية:

النطاق
`https://www.googleapis.com/auth/calendar.readonly`
`https://www.googleapis.com/auth/calendar`
`https://www.googleapis.com/auth/calendar.events.readonly`
`https://www.googleapis.com/auth/calendar.events`

للحصول على مزيد من المعلومات، يُرجى الاطّلاع على صفحة المصادقة والتفويض.

نص الطلب

لا توفِّر نص طلب بهذه الطريقة.

الإجابة

وفي حال نجاحها، تعرِض هذه الطريقة مورد الأحداث في نص الاستجابة.

أمثلة

ملاحظة: إنّ الأمثلة المرتبطة بالرموز والمتوفرة لهذه الطريقة لا تمثّل كل لغات البرمجة المتوافقة (يُرجى مراجعة صفحة مكتبات البرامج للاطّلاع على قائمة باللغات المتوافقة).

Java

تستخدم مكتبة عميل Java.

import com.google.api.services.calendar.Calendar;
import com.google.api.services.calendar.model.Event;

// ...

// Initialize Calendar service with valid OAuth credentials
Calendar service = new Calendar.Builder(httpTransport, jsonFactory, credentials)
    .setApplicationName("applicationName").build();

// Retrieve an event
Event event = service.events().get('primary', "eventId").execute();

System.out.println(event.getSummary());

Python

تستخدم مكتبة برامج Python.

event = service.events().get(calendarId='primary', eventId='eventId').execute()

print event['summary']

PHP

لاستخدام مكتبة برامج PHP.

$event = $service->events->get('primary', "eventId");

echo $event->getSummary();

Ruby

تستخدم مكتبة عميل Ruby.

result = client.get_event('primary', 'eventId')
print result.summary

تجربة

يمكنك استخدام مستكشف واجهات برمجة التطبيقات أدناه لطلب هذه الطريقة على البيانات المباشرة والاطّلاع على الاستجابة.