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

Events: get

عرض حدث استنادًا إلى معرّف تقويم Google. لاسترداد حدث باستخدام معرّف iتقويم Google، يمكنك استدعاء طريقة 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

جرّب الآن

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