So erstellen Sie ein Dienstkonto

Hierfür müssen Sie ein eigenes Konto in den Google-Diensten erstellen.

Gehen Sie zu diesem Link und erstellen Sie ein neues Projekt:

Überlegen Sie sich einen Namen für das Projekt:

Klicken Sie auf „Erstellen“ und warten Sie einen Moment, während das Projekt erstellt wird.

Laden Sie die Seite neu und klicken Sie dann auf das soeben erstellte Projekt. Überprüfen Sie im Feld links Ihren Zugriffsstatus – es muss „Inhaber (1)“ angezeigt werden:

Gehen Sie nun zu den Einstellungen des Dienstkontos:

Dort müssen Sie den Abschnitt „Dienstkonten“ öffnen und auf „+ Dienstkonto erstellen“ klicken:

Geben Sie den Namen und die E-Mail-Adresse des Dienstkontos ein:

Wählen Sie dann die Rolle „Inhaber“ aus:

Klicken Sie auf „Fertig“ und dann beim ausgewählten Projekt auf „Schlüssel verwalten“. Klicken Sie dann auf „Neuen Schlüssel erstellen“:

Wählen Sie den JSON-Schlüsseltyp aus und klicken Sie auf „Erstellen“:

Nachdem Sie den Schlüssel erstellt haben, wird er automatisch auf Ihrem Computer gespeichert:

Dann müssen Sie ihn auf das Hosting oder auf Mavibot herunterladen und den Link dazu in den Anforderungsparametern teilen, indem Sie die erhaltene URL im Parameter creds_path angeben.

Jetzt müssen Sie auch unsere API-Integrationen hinzufügen. Gehen Sie dazu hierhin:

Dann müssen Sie APIs und Dienste aktivieren und im geöffneten Fenster nach der Google Kalender API suchen:

Klicken Sie auf das Suchergebnis und dann auf „Aktivieren“:

Dieser Schritt schließt die Erstellung Ihres Dienstkontos ab.

So laden Sie die Schlüsseldatei herunter

Wechseln Sie zum Projekt auf Mavibot und laden Sie die erhaltene Schlüsseldatei in einen Block herunter, zum Beispiel so:

Klicken Sie auf „Speichern“ und wechseln Sie zum kostenlosen Testfenster:

Geben Sie den von Ihnen als Bedingung festgelegten Satz ein (in diesem Fall „123“). Sie erhalten als Antwort einen Link zur Datei mit den Schlüsseln:

Sie können den Block nicht löschen, da sonst die Datei vom Server gelöscht wird und Sie sie erneut hinzufügen müssen.

Vergessen Sie nicht, den Block vom Typ „Nicht-Status“ zu machen, damit er Sie nicht stört.

Sie können diesen Link in einer Variable speichern oder ihn so wie er ist im Parameter creds_path übergeben.

So finden Sie die Kalender-ID

Sie finden die ID des vorhandenen Kalenders in seinen Einstellungen im Abschnitt „Kalender integrieren“:

So erstellen Sie einen neuen Kalender

Sie können einen neuen Kalender auf zwei Arten erstellen: manuell und mithilfe einer Funktion.

Manuelle Kalendererstellung:

Damit Sie Notizen hinzufügen und einen vorhandenen (oder manuell erstellten) Kalender bearbeiten können, müssen Sie dem Dienstkonto Zugriff gewähren. Fügen Sie dazu einfach die E-Mail-Adresse des Dienstkontos in den Einstellungen des gewünschten Kalenders hinzu:

Kalendererstellung mit einer Funktion

Funktions-URL: https://store.salebot.ai/function/gcalendar
Anforderungstyp: POST-json

Parameter:

creds_path - der Link zum Zugriffsschlüssel des Dienstkontos auf die Kalender-API (erhalten mit der obigen Anleitung);
command - create
name - Kalendername
description - Kalenderbeschreibung

Zusätzliche Parameter:

time_zone - die Zeitzone des Kalenders. IANA-Zeitzonen-ID. Standardmäßig Europe/Moscow (GMT+3)
location - ein geografischer Standort des Kalenders als Text in beliebiger Form

Sie können auch einem anderen Konto Zugriff gewähren, z. B. Ihrem Hauptkonto:

owner_email - E-Mail-Adresse des Kontos, das als Inhaber des Kalenders hinzugefügt wird

Standardmäßig wird der Kalender im Dienstkonto erstellt. Um den Kalender von Ihrem eigenen Konto aus visuell bearbeiten zu können, übergeben Sie Ihre E-Mail-Adresse im Parameter owner_email.

Gespeicherte Werte aus der JSON-Antwort

Nach erfolgreicher Ausführung gibt die Funktion diese nächsten Parameter zurück, die Sie speichern und aufbewahren können:

{'kind': 'calendar#calendar', 'etag': '"WgASl9FY_5zrEmCZvrt4Qlh6tGQ"', 'id': '[email protected]', 'summary': 'Kalendername', 'timeZone': 'UTC'}

Speichern wir die ID des erstellten Kalenders: id -> calendar_id

Zum Testen können Sie die Variable #{custom_answer} anzeigen.

Wenn die E-Mail-Adresse (owner_email) übergeben wurde, müssen Sie nach erfolgreicher Anfrage zu Ihrem E-Mail-Posteingang gehen und das Hinzufügen des Kalenders zu Ihrem Konto bestätigen:

So erhalten Sie Informationen über den Kalender

Funktions-URL: https://store.salebot.ai/function/gcalendar
Anforderungstyp: POST-json

Parameter:

creds_path - der Link zum Zugriffsschlüssel des Dienstkontos auf die Kalender-API (erhalten mit der obigen Anleitung);
command - get_calendar;
calendar_id - die ID des ausgewählten Kalenders

Gespeicherte Werte

Nach erfolgreicher Ausführung gibt die Funktion diese nächsten Parameter zurück, die Sie speichern und aufbewahren können.

Ein Beispiel der Funktionsantwort:

{'kind': 'calendar#calendar', 'etag': '"6KN4OTLeoqGGu7Nr5uNIQgCGYsU"', 'id': '[email protected]', 'summary': 'Kalendername', 'timeZone': 'UTC'}

So erhalten Sie die Liste der Kalender des Dienstkontos

Funktions-URL: https://store.salebot.ai/function/gcalendar
Anforderungstyp: POST-json

Parameter:

creds_path - der Link zum Zugriffsschlüssel des Dienstkontos auf die Kalender-API (erhalten mit der obigen Anleitung);
command - calendars_list

Gespeicherte Werte

Nach erfolgreicher Ausführung gibt die Funktion diese nächsten Parameter zurück, die Sie speichern und aufbewahren können.

Ein Beispiel der Funktionsantwort:

{
'kind': 'calendar#calendarList',
'etag': '"p32o8pm47rfqf20g"',
'nextSyncToken': 'CLCM2Ifb9PECEi5nc2hlZXRzQGdzaGVldHMtMjU0NzEzLmlhbS5nc2VydmljZWFjY291bnQuY29t',
'items': [
{
'kind': 'calendar#calendarListEntry',
'etag': '"1625235372775000"',
'id': '[email protected]',
'summary': 'AAAAAAAAaa',
'timeZone': 'Asia/Singapore',
'colorId': '17',
'backgroundColor': '#9a9cff',
'foregroundColor': '#000000',
'selected': True,
'accessRole': 'owner',
'defaultReminders': [
]
},
{
'kind': 'calendar#calendarListEntry',
'etag': '"1625235805096000"',
'id': '[email protected]',
'summary': 'AAAAAAAAaa',
'timeZone': 'Asia/Singapore',
'colorId': '21',
'backgroundColor': '#cca6ac',
'foregroundColor': '#000000',
'selected': True,
'accessRole': 'owner',
'defaultReminders': [
]
}
]
}

So arbeiten Sie mit Ereignissen

Schnelles Hinzufügen eines Ereignisses

Funktions-URL: https://store.salebot.ai/function/gcalendar
Anforderungstyp: POST-json

Parameter:

creds_path - der Link zum Zugriffsschlüssel des Dienstkontos auf die Kalender-API (erhalten mit der obigen Anleitung);
command - quick_add_event;
calendar_id - die ID des ausgewählten Kalenders;
event_name - der Name des Ereignisses

Ein Beispiel der Parameter:

{"creds_path": "https://files.salebot.ai/uploads/message/file/30037/calendar-project-320517-c241d9ab0565.json", "calendar_id": "[email protected]", "command": "quick_add_event","event_name": "Unglaubliches Ereignis"}

Gespeicherte Werte

Nach erfolgreicher Ausführung gibt die Funktion diese nächsten Parameter zurück, die Sie speichern und aufbewahren können. Um das erstellte Ereignis später bearbeiten zu können, wird empfohlen, seine ID zu speichern: id -> event_id.

Ein Beispiel der Funktionsantwort:

{
'kind': 'calendar#event',
'etag': '"3253879667088000"',
'id': 'ljp7a3ocp8oorbov9u2cq221s0',
'status': 'confirmed',
'htmlLink': 'https://www.google.com/calendar/event?eid=bGpwN2Ezb2NwOG9vcmJvdjl1MmNxMjIxczAgaTlzdmVydHN0dm9vMmZxMW8waThjbjM5YThAZw',
'created': '2021-07-22T07:43:53.000Z',
'updated': '2021-07-22T07:43:53.544Z',
'creator': {'email': '[email protected]'},
'organizer': {'email': '[email protected]',
'displayName': 'Testov',
'self': True},
'start': {'dateTime': '2021-07-22T07:43:53Z', 'timeZone': 'UTC'},
'end': {'dateTime': '2021-07-22T08:43:53Z', 'timeZone': 'UTC'},
'iCalUID': '[email protected]',
'sequence': 0,
'reminders': {'useDefault': True},
'eventType': 'default'
}

So fügen Sie ein Ereignis hinzu

Funktions-URL: https://store.salebot.ai/function/gcalendar
Anforderungstyp: POST-json

Parameter:

creds_path - der Link zum Zugriffsschlüssel des Dienstkontos auf die Kalender-API (erhalten mit der obigen Anleitung);
command - add_event
calendar_id - die ID des ausgewählten Kalenders
event_name - der Name des Ereignisses

Sie müssen auch eine von zwei Parameteroptionen festlegen: Datum ODER Datum und Uhrzeit.

Wenn das Ereignis den ganzen Tag dauert, müssen Sie Daten angeben:

  1. start_date - das Startdatum des Ereignisses im Format DD.MM.YYYY (z. B. 23.07.2010)
  2. end_date - das Enddatum des Ereignisses im Format DD.MM.YYYY (z. B. 24.07.2010)

Wenn das Ereignis zu einer bestimmten Zeit stattfindet, müssen Sie das Datum und die Uhrzeit angeben:

  1. start_datetime - das Startdatum und die Startuhrzeit des Ereignisses im Format DD.MM.YYYY HH:MM (z. B. 23.07.2010 12:00)
  2. end_datetime - das Enddatum und die Enduhrzeit des Ereignisses im Format DD.MM.YYYY HH:MM (z. B. 23.07.2010 13:00)
  3. time_zone - die Zeitzone des Ereignisses. IANA-Zeitzonen-ID. Standardmäßig Europe/Moscow (GMT+3)

Wenn die Zeitzonen des Kalenders und des Ereignisses unterschiedlich sind, wird das Ereignis mit Uhrzeit in der Zeitzone des Kalenders hinzugefügt.

Beispiel:

Der Kalender befindet sich in der Zeitzone (tz) Europe/Kyiv +3, und das Ereignis wird mit der Zeitzone Europe/Berlin +2 hinzugefügt. Die Uhrzeit des Ereignisses um 12:00 Uhr (tz +2) wird im Kalender als 13:00 Uhr hinzugefügt, da 13:00 Uhr in Kiewer Zeit 12:00 Uhr in der +2-Zeitzone entspricht.

Zusätzliche Parameter:

event_description - die Beschreibung des Ereignisses
location - der geografische Standort des Ereignisses als Freitext
email_minutes - die Zeit in Minuten vor dem Ereignis, um eine Benachrichtigung an die E-Mail-Adressen der Teilnehmer zu senden
popup_minutes - die Zeit in Minuten vor dem Ereignis, um eine Pop-up-Benachrichtigung an die Teilnehmer zu senden

Ein Beispiel der Parameter:

{"creds_path": "https://files.salebot.ai/uploads/message/file/30037/calendar-project-320517-c241d9ab0565.json", "calendar_id": "[email protected]", "command": "add_event", "event_name": "Das großartigste Ereignis aller Zeiten", "start_datetime": "27.07.2021 12:00", "end_datetime": "27.07.2021 14:00"}

Gespeicherte Werte aus der JSON-Antwort:

Nach erfolgreicher Ausführung gibt die Funktion diese nächsten Parameter zurück, die Sie speichern und aufbewahren können.

Für die zukünftige Bearbeitung des erstellten Ereignisses wird empfohlen, seine ID zu speichern:

id -> event_id

Ein Beispiel der Funktionsantwort:

{'kind': 'calendar#event', 'etag': '"3254057128970000"', 'id': 'ittr5291ppi7snapn8jbct5krs', 'status': 'confirmed', 'htmlLink': 'https://www.google.com/calendar/event?eid=aXR0cjUyOTFwcGk3c25hcG44amJjdDVrcnMgaTlzdmVydHN0dm9vMmZxMW8waThjbjM5YThAZw', 'created': '2021-07-23T08:22:35.000Z', 'updated': '2021-07-23T08:22:53.109Z', 'summary': 'Neues Ereignis44', 'description': 'Beschreibung xbb xhjxkv', 'location': 'Stadt London', 'creator': {'email': '[email protected]'}, 'organizer': {'email': '[email protected]', 'displayName': 'Test', 'self': True}, 'start': {'dateTime': '2021-07-23T13:30:00Z', 'timeZone': 'Europe/Kyiv'}, 'end': {'dateTime': '2021-07-23T14:00:00Z', 'timeZone': 'Europe/Kyiv'}, 'iCalUID': '[email protected]', 'sequence': 0, 'attendees': [{'email': '[email protected]', 'displayName': 'John', 'responseStatus': 'needsAction'}], 'reminders': {'useDefault': False, 'overrides': [{'method': 'email', 'minutes': 10}, {'method': 'popup', 'minutes': 10}]}, 'eventType': 'default'}

Bearbeiten des Ereignisses

Funktions-URL: https://store.salebot.ai/function/gcalendar
Anforderungstyp: POST-json

Erforderliche Parameter:

creds_path - der Link zum Zugriffsschlüssel des Dienstkontos auf die Kalender-API (erhalten mit der obigen Anleitung);
command - update_event;
calendar_id - die ID des Kalenders;
event_id - die ID des zu bearbeitenden Ereignisses

Optionale Parameter für eine Aktualisierung:

Sie können einen oder mehrere Parameter übergeben.

event_name - der Name des Ereignisses
event_description - die Beschreibung des Ereignisses
email_minutes - die Zeit in Minuten vor dem Ereignis, um eine Benachrichtigung an die E-Mail-Adressen der Teilnehmer zu senden
popup_minutes - die Zeit in Minuten vor dem Ereignis, um eine Pop-up-Benachrichtigung an die Teilnehmer zu senden

Wenn das Ereignis den ganzen Tag dauert, müssen Sie Daten angeben:

start_date - das Startdatum des Ereignisses im Format DD.MM.YYYY (z. B. 23.07.2010)
end_date - das Enddatum des Ereignisses im Format DD.MM.YYYY (z. B. 24.07.2010)

Wenn das Ereignis zu einer bestimmten Zeit stattfindet, müssen Sie das Datum und die Uhrzeit angeben:

start_datetime - das Startdatum und die Startuhrzeit des Ereignisses im Format DD.MM.YYYY HH:MM (z. B. 23.07.2010 12:00)
end_datetime - das Enddatum und die Enduhrzeit des Ereignisses im Format DD.MM.YYYY HH:MM (z. B. 23.07.2010 13:00)
time_zone - die Zeitzone des Ereignisses. IANA-Zeitzonen-ID. Standardmäßig Europe/Moscow (GMT+3)

Ein Beispiel der Parameter:

{"creds_path": "https://files.salebot.ai/uploads/message/file/30037/calendar-project-320517-c241d9ab0565.json", "calendar_id": "[email protected]", "event_id": "j1lcpm4q2p9c0cv705alv3brug", "command": "update_event", "event_name": "Bearbeitetes Ereignis", "start_datetime": "27.07.2021 12:00", "end_datetime": "27.07.2021 14:00","popup_minutes": "11","email_minutes": "22"}

Gespeicherte Werte aus der JSON-Antwort:

Nach erfolgreicher Ausführung gibt die Funktion diese nächsten Parameter zurück, die Sie speichern und aufbewahren können.

Ein Beispiel der Funktionsantwort:

{"kind":"calendar#event","etag":""3276713558524000"","id":"j1lcpm4q2p9c0cv705alv3brug","status":"confirmed","htmlLink":"https://www.google.com/calendar/event?eid=ajFsY3BtNHEycDljMGN2NzA1YWx2M2JydWcgaTlzdmVydHN0dm9vMmZxMW8waThjbjM5YThAZw","created":"2021-12-01T10:40:11.000Z","updated":"2021-12-01T10:43:16.738Z","summary":"Erstaunlich","creator":{"email":"[email protected]"},"organizer":{"email":"[email protected]","displayName":"Test","self":true},"start":{"dateTime":"2021-12-28T09:00:00Z","timeZone":"Europe/Moscow"},"end":{"dateTime":"2021-12-29T11:00:00Z","timeZone":"Europe/Moscow"},"iCalUID":"[email protected]","sequence":0,"reminders":{"useDefault":false,"overrides":[{"method":"email","minutes":22},{"method":"popup","minutes":12}]},"eventType":"default","update_status":"ok"}

Abrufen einer Liste von Ereignissen

Funktions-URL: https://store.salebot.ai/function/gcalendar
Anforderungstyp: POST-json

Parameter:

creds_path - der Link zum Zugriffsschlüssel des Dienstkontos auf die Kalender-API (erhalten mit der obigen Anleitung);
command - get_event_list;
calendar_id - die ID des Kalenders

Wenn Sie keine zusätzlichen Parameter übergeben, ist das Ergebnis eine Liste der heutigen Ereignisse.

Zusätzliche Parameter:

start_date - das Datum, ab dem Sie Ereignisse suchen möchten, im Format DD.MM.YYYY (23.07.2021)
end_date - das Datum, bis zu dem Sie Ereignisse suchen möchten, im Format DD.MM.YYYY (24.07.2021)

Ein Beispiel der Parameter:

Das Ereignis für den 23. Juli wird gefunden.

{"creds_path": "https://files.salebot.ai/uploads/message/file/30037/calendar-project-320517-c241d9ab0565.json", "calendar_id": "[email protected]", "command": "get_event_list", "start_date": "22.07.2021", "end_date": "23.07.2021"}

Gespeicherte Werte aus der JSON-Antwort:

Nach erfolgreicher Ausführung gibt die Funktion diese nächsten Parameter zurück, die Sie speichern und aufbewahren können.

Die Liste der gefundenen Ereignisse kann in einer Variable gespeichert werden:

items -> event_list

Ein Beispiel der Funktionsantwort:

{'kind': 'calendar#events', 'etag': '"p33odnesrinsv20g"', 'summary': 'Test', 'description': 'Testbeschreibung', 'updated': '2021-07-23T12:13:05.686Z', 'timeZone': 'UTC', 'accessRole': 'owner', 'defaultReminders': [], 'items': [{'kind': 'calendar#event', 'etag': '"3254084771372000"', 'id': '6d8rocb9e2r21ue37jgsa0v06i', 'status': 'confirmed', 'htmlLink': 'https://www.google.com/calendar/event?eid=NmQ4cm9jYjllMnIyMXVlMzdqZ3NhMHYwNmkgaTlzdmVydHN0dm9vMmZxMW8waThjbjM5YThAZw', 'created': '2021-07-23T12:11:13.000Z', 'updated': '2021-07-23T12:13:05.686Z', 'summary': 'DDDDDDDDD', 'creator': {'email': '[email protected]'}, 'organizer': {'email': '[email protected]', 'displayName': 'Testov', 'self': True}, 'start': {'date': '2021-07-20'}, 'end': {'date': '2021-07-21'}, 'transparency': 'transparent', 'iCalUID': '[email protected]', 'sequence': 0, 'reminders': {'useDefault': False}, 'eventType': 'default'}]}

So verschieben Sie Ereignisse in einen anderen Kalender

Funktions-URL: https://store.salebot.ai/function/gcalendar
Anforderungstyp: POST-json

Parameter:

creds_path - der Link zum Zugriffsschlüssel des Dienstkontos auf die Kalender-API (erhalten mit der obigen Anleitung);
command - move_event;
calendar_id - die ID des Kalenders, aus dem das Ereignis verschoben wird;
event_id - die ID des Ereignisses;
destination_calendar_id - die ID des Kalenders, in den das Ereignis verschoben wird;

Gespeicherte Werte aus der JSON-Antwort:

Nach erfolgreicher Ausführung gibt die Funktion diese nächsten Parameter zurück, die Sie speichern und aufbewahren können.

Ein Beispiel der Funktionsantwort:

{'kind': 'calendar#event', 'etag': '"3253880350568000"', 'id': 'ljp7a3ocp8oorbov9u2cq221s0', 'status': 'cancelled', 'htmlLink': 'https://www.google.com/calendar/event?eid=bGpwN2Ezb2NwOG9vcmJvdjl1MmNxMjIxczAgaTlzdmVydHN0dm9vMmZxMW8waThjbjM5YThAZw', 'created': '2021-07-22T07:43:53.000Z', 'updated': '2021-07-22T07:49:35.284Z', 'creator': {'email': '[email protected]'}, 'organizer': {'email': '[email protected]', 'displayName': 'Testkalender'}, 'start': {'dateTime': '2021-07-22T07:43:53Z', 'timeZone': 'UTC'}, 'end': {'dateTime': '2021-07-22T08:43:53Z', 'timeZone': 'UTC'}, 'iCalUID': '[email protected]', 'sequence': 0, 'reminders': {'useDefault': True}, 'eventType': 'default'}

So erhalten Sie Informationen zu einem Ereignis

Funktions-URL: https://store.salebot.ai/function/gcalendar
Anforderungstyp: POST-json

Parameter:

creds_path - der Link zum Zugriffsschlüssel des Dienstkontos auf die Kalender-API (erhalten mit der obigen Anleitung);
command - get_event;
calendar_id - die ID des Kalenders;
event_id - die ID des Ereignisses

Gespeicherte Werte aus der JSON-Antwort:

Nach erfolgreicher Ausführung gibt die Funktion diese nächsten Parameter zurück, die Sie speichern und aufbewahren können.

Ein Beispiel der Funktionsantwort:

{'kind': 'calendar#event', 'etag': '"3254067331414000"', 'id': 'ittr5291ppi7snapn8jbct5krs', 'status': 'confirmed', 'htmlLink': 'https://www.google.com/calendar/event?eid=aXR0cjUyOTFwcGk3c25hcG44amJjdDVrcnMgaTlzdmVydHN0dm9vMmZxMW8waThjbjM5YThAZw', 'created': '2021-07-23T08:22:35.000Z', 'updated': '2021-07-23T11:12:55.553Z', 'summary': 'Neues Ereignis44', 'description': 'Beschreibung xbb xhjxkv', 'location': 'Stadt London', 'creator': {'email': '[email protected]'}, 'organizer': {'email': '[email protected]', 'displayName': 'Test', 'self': True}, 'start': {'dateTime': '2021-07-23T13:30:00Z', 'timeZone': 'Europe/Moscow'}, 'end': {'dateTime': '2021-07-23T14:00:00Z', 'timeZone': 'Europe/Moscow'}, 'iCalUID': '[email protected]', 'sequence': 0, 'attendees': [{'email': '[email protected]', 'displayName': 'John', 'responseStatus': 'needsAction'}], 'reminders': {'useDefault': False, 'overrides': [{'method': 'email', 'minutes': 10}, {'method': 'popup', 'minutes': 10}]}, 'eventType': 'default'}

So löschen Sie ein Ereignis

Funktions-URL: https://store.salebot.ai/function/gcalendar
Anforderungstyp: POST-json

Parameter:

creds_path - der Link zum Zugriffsschlüssel des Dienstkontos auf die Kalender-API (erhalten mit der obigen Anleitung);
command - remove_event;
calendar_id - die ID des Kalenders;
event_id - die ID des zu löschenden Ereignisses

Gespeicherte Werte aus der JSON-Antwort:

Nach erfolgreicher Ausführung gibt die Funktion diese nächsten Parameter zurück, die Sie speichern und aufbewahren können.

Ein Beispiel der Funktionsantwort:

{'status': 'ok'}

So fügen Sie einen Ereignisteilnehmer hinzu

Funktions-URL: https://store.salebot.ai/function/gcalendar
Anforderungstyp: POST-json

Parameter:

creds_path - der Link zum Zugriffsschlüssel des Dienstkontos auf die Kalender-API (erhalten mit der obigen Anleitung);
command - add_client;
calendar_id - die ID des Kalenders;
event_id - die ID des Ereignisses;
client_email - die E-Mail-Adresse des hinzuzufügenden Kunden

Zusätzliche Parameter:

name - der Name des Ereignisses;
comment - Kommentar des Teilnehmers

Ein Beispiel der Parameter:

{
"creds_path": "https://files.salebot.ai/uploads/message/file/30037/calendar-project-320517-c241d9ab0565.json",
"calendar_id": "[email protected]",
"command": "add_client",
"event_id": "#{event_id}",
"client_email": "[email protected]",
"name": "John",
"comment": "Ich werde der Erste sein!"
}

Gespeicherte Werte aus der JSON-Antwort:

Die Funktion gibt immer den Status add_status zurück. Er kann einen von drei Werten annehmen:

ok - der Kunde wurde hinzugefügt
exist - der Kunde existiert bereits
error - es ist ein Fehler beim Hinzufügen aufgetreten, dann gibt es zusätzlich zu add_status einen Parameter error_message mit dem Fehlertext

Ein Beispiel der Funktionsantwort im Erfolgsfall:

{'kind': 'calendar#event', 'etag': '"3254059247409000"', 'id': 'ittr5291ppi7snapn8jbct5krs', 'status': 'confirmed', 'htmlLink': 'https://www.google.com/calendar/event?eid=aXR0cjUyOTFwcGk3c25hcG44amJjdDVrcnMgaTlzdmVydHN0dm9vMmZxMW8waThjbjM5YThAZw', 'created': '2021-07-23T08:22:35.000Z', 'updated': '2021-07-23T08:58:11.548Z', 'summary': 'Neues Ereignis44', 'description': 'Beschreibung xbb xhjxkv', 'location': 'Stadt London', 'creator': {'email': '[email protected]'}, 'organizer': {'email': '[email protected]', 'displayName': 'Test', 'self': True}, 'start': {'dateTime': '2021-07-23T13:30:00Z', 'timeZone': 'Europe/Moscow'}, 'end': {'dateTime': '2021-07-23T14:00:00Z', 'timeZone': 'Europe/Moscow'}, 'iCalUID': '[email protected]', 'sequence': 0, 'attendees': [{'email': '[email protected]', 'displayName': 'John', 'responseStatus': 'needsAction'}, {'email': '[email protected]', 'displayName': 'John', 'responseStatus': 'needsAction'}, {'email': '[email protected]', 'displayName': 'John2', 'responseStatus': 'needsAction'}], 'reminders': {'useDefault': False, 'overrides': [{'method': 'email', 'minutes': 10}, {'method': 'popup', 'minutes': 10}]}, 'eventType': 'default', 'add_status': 'ok'}

So löschen Sie einen Teilnehmer

Funktions-URL: https://store.salebot.ai/function/gcalendar
Anforderungstyp: POST-json

Parameter:

creds_path - der Link zum Zugriffsschlüssel des Dienstkontos auf die Kalender-API (erhalten mit der obigen Anleitung);
command - remove_client;
calendar_id - die ID des Kalenders;
event_id - die ID des Ereignisses;
client_email - die E-Mail-Adresse des Kunden

Ein Beispiel der Parameter:

{
"creds_path": "https://files.salebot.ai/uploads/message/file/30037/calendar-project-320517-c241d9ab0565.json",
"calendar_id": "[email protected]",
"command": "remove_client",
"event_id": "#{event_id}",
"client_email": "[email protected]"
}

Gespeicherte Werte aus der JSON-Antwort:

Die Funktion gibt immer den Status remove_status zurück. Er kann einen von drei Werten annehmen:

1 - der Kunde wurde erfolgreich entfernt
0 - der Kunde wurde nicht gefunden
error - ein Fehler während des Entfernungsvorgangs, dann gibt es zusätzlich zu remove_status einen Parameter error_message mit dem Fehlertext

Die Funktionsantwort im Erfolgsfall:

{'kind': 'calendar#event', 'etag': '"3254059247409000"', 'id': 'ittr5291ppi7snapn8jbct5krs', 'status': 'confirmed', 'htmlLink': 'https://www.google.com/calendar/event?eid=aXR0cjUyOTFwcGk3c25hcG44amJjdDVrcnMgaTlzdmVydHN0dm9vMmZxMW8waThjbjM5YThAZw', 'created': '2021-07-23T08:22:35.000Z', 'updated': '2021-07-23T08:58:11.548Z', 'summary': 'Neues Ereignis44', 'description': 'Beschreibung xbb xhjxkv', 'location': 'Stadt London', 'creator': {'email': '[email protected]'}, 'organizer': {'email': '[email protected]', 'displayName': 'Test', 'self': True}, 'start': {'dateTime': '2021-07-23T13:30:00Z', 'timeZone': 'Europe/Moscow'}, 'end': {'dateTime': '2021-07-23T14:00:00Z', 'timeZone': 'Europe/Moscow'}, 'iCalUID': '[email protected]', 'sequence': 0, 'attendees': [{'email': '[email protected]', 'displayName': 'John', 'responseStatus': 'needsAction'}, {'email': '[email protected]', 'displayName': 'John', 'responseStatus': 'needsAction'}, {'email': '[email protected]', 'displayName': 'John2', 'responseStatus': 'needsAction'}], 'reminders': {'useDefault': False, 'overrides': [{'method': 'email', 'minutes': 10}, {'method': 'popup', 'minutes': 10}]}, 'eventType': 'default', 'remove_status': '1'}