---
sourceDocument: Yokohama-API-Referenz
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/de-DE/yokohama/api-reference

 Release :

    - yokohama

ft:locale :

    - de-DE

ft:publication_title :

    - Yokohama-API-Referenz

ft:clusterId :

    - crapiref

bundleId :

    - crapiref

workflow :

    - Creator


---

# Aktivitätsabonnements-API

# Aktivitätsabonnements-API {#ariaid-title1}

* Freigeben Version: Yokohama
* 
* Aktualisiert 30. Januar 2025
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 14 Minuten Lesedauer

Die Aktivitätsabonnements Die API stellt Endpunkte zum Abrufen von Aktivitätsentitäten aus den Abonnements und dem Aktivitäts-Feed-Framework bereit.
Diese API erfordert die Aktivierung des Plugins „Abonnements" und „Aktivitäts-Feed-Framework" (com.snc.activity_Subscriptions). Aktivieren Sie das Plugin „Kundenzentrale" (com.sn_csm_customer_central), um die Konfiguration in allen erforderlichen Tabellen zu Seeding zu erstellen. Weitere Informationen zu den Konfigurationseinstellungen der Kundenzentrale finden Sie unter [Konfigurieren Sie die Kundenzentrale](https://www.servicenow.com/docs/access?context=configure-customer-central&version=yokohama&pubname=yokohama-customer-service-management&ft:locale=en-US).

## Aktivitätsabonnements -- GET /now/actsub/activities {#ariaid-title2}

Ruft Aktivitätsdatensätze aus den Abonnements und dem Aktivitäts-Feed-Framework ab.
Für den Zugriff auf diesen Endpunkt ist keine Rolle erforderlich, die zurückgegebenen Daten werden jedoch durch Anwenderzugriffseinstellungen eingeschränkt.

### URL-Format

Versionierte URL: /api/now/{api_Version}/actsub/activities

Standard-URL: /api/now/actsub/activities  
Hinweis:  
Verfügbare Versionen werden in angegeben [REST-API-Explorer](https://servicenow-prod.fluidtopics.net/QZyr9s_~V0xB9fqGOlvJ4A "In diesem Tutorial verwenden Sie den REST API Explorer, um zu testen ServiceNowREST-APIs."). Für geskriptete REST-APIs gibt es zusätzliche Versionsinformationen auf [Geskriptetes REST-Service-Formular](https://servicenow-prod.fluidtopics.net/0V9QfkPsOI5r~YAD7CJWCA "Mit der geskripteten REST-API-Funktion können Anwendungsentwickler anwenderdefinierte Webservice-APIs erstellen.").

### Unterstützte Anforderungsparameter

{#actsub-GET-activities__entry__2}{#actsub-GET-activities__version-not_optional-RESTAPI}

| Name | Beschreibung |
|-|-|
| api_version | Optional. Version des Endpunkts, auf den zugegriffen werden soll. Beispiel: <kbd class="ph userinput">v1 </kbd>Oder <kbd class="ph userinput">v2 </kbd>. Geben Sie diesen Wert nur an, um eine andere Endpunktversion als die neueste zu verwenden. Datentyp: Zeichenfolge |
[Tabelle : 1. Pfad-Parameter]

{#actsub-GET-activities__entry__6}{#actsub-GET-activities__end-date-query-param-entry}{#actsub-GET-activities__start-date-query-param-entry}

| Name | Beschreibung |
|-|-|
| vor | Datums-/Uhrzeitwert. Die Anforderung gibt nur Datensätze zurück, die vor diesem Datum und dieser Uhrzeit erstellt wurden. Datentyp: Zeichenfolge Format: JJJJ-MM-TT hh:mm:ss oder JJJJ-MM-TT |
| context | Erforderlich. SYS_ID eines Aktivitätskontexts. Vordefinierte Aktivitätskontexte umfassen Verbraucher und Kontakt. Datentyp: Zeichenfolge Tabelle: Aktivitätskontext \[sn_actsub_activity_context\] |
| Context_instance | Erforderlich. SYS_ID einer Instanz des angegebenen Aktivitätskontexts, die den Initiator der Aktivitäten darstellt, die Sie abrufen möchten. Befindet sich in der entsprechenden Tabelle für den Aktivitätskontext. Beispiel: Wenn Sie festlegen contextLegen Sie diesen Parameter auf die sys_ID des Verbraucheraktivitätskontexts auf die sys_ID des Verbrauchertabellendatensatzes \[csm_Consumer\] für den Verbraucher fest, dessen Aktivitäten Sie abrufen möchten. Datentyp: Zeichenfolge |
| end_date | Datums-/Uhrzeitwert. Die Anforderung gibt nur Datensätze zurück, die während des von definierten Zeitraums erstellt wurden start_dateUnd diesen Parameter. Muss zusammen mit festgelegt werden start_date. Datentyp: Zeichenfolge Format: JJJJ-MM-TT hh:mm:ss oder JJJJ-MM-TT |
| Aspekte | Kommagetrennte Liste von sys_IDs von Aktivitätsaspekttypen, die für den angegebenen Aktivitätskontext abgerufen werden sollen. Weitere Informationen zu Aktivitätsaspekten finden Sie unter [Erstellen Sie Aspekte für Aktivitätskontexte](https://www.servicenow.com/docs/access?context=create-facet-customer-central&version=yokohama&pubname=yokohama-customer-service-management&ft:locale=en-US). Datentyp: Zeichenfolge Standard: Gibt alle für den Aktivitätskontext konfigurierten Aktivitätsaspekttypen zurück. Tabelle: Aktivitätsaspekt \[sn_actsub_facet\] |
| letzte | Indexwert der ersten Ergebniszeile, die im Antworttext ausgelassen wurde. Der Ergebniszeilenindex beginnt bei 0, daher ist die letzte im Antworttext enthaltene Zeile die mit dem Index last-1. Beispiel: Einstellung `Zuletzt=5 `Ignoriert Zeilen mit Index 5 und höher und gibt höchstens die ersten fünf Ergebniszeilen zurück (mit Indexwerten 0 bis 4). Einstellung `StFrom=1 `Und `Zuletzt=5 `Überspringt die erste Ergebniszeile und gibt die zweite bis fünfte Ergebniszeile zurück (mit Indexwerten 1 bis 4). Datentyp: Zahl (Ganzzahl) Standard: Der Wert von Com.snc.actsub.activities.api.fetch.limit Systemeigenschaft (standardmäßig 10). |
| record_id | SYS_ID eines Datensatzes, der beim Rendern dynamischer Aspekte verwendet werden soll. Befindet sich in der entsprechenden Tabelle für den Aktivitätstyp, den Sie abrufen möchten. Wenn Sie beispielsweise Aktivitäten für einen Falldatensatz abrufen möchten, legen Sie diesen Parameter auf die sys_ID des betreffenden Falldatensatzes fest. Weitere Informationen zu dynamischen Aspekten finden Sie unter [Erstellen Sie Aspekte für Aktivitätskontexte](https://www.servicenow.com/docs/access?context=create-facet-customer-central&version=yokohama&pubname=yokohama-customer-service-management&ft:locale=en-US). Datentyp: Zeichenfolge |
| start_date | Datums-/Uhrzeitwert. Die Anforderung gibt nur Datensätze zurück, die während des durch diesen Parameter und definierten Zeitraums erstellt wurden end_date. Muss zusammen mit festgelegt werden end_date. Datentyp: Zeichenfolge Format: JJJJ-MM-TT hh:mm:ss oder JJJJ-MM-TT |
| Stab | Indexwert der ersten Ergebniszeile, die in den Antworttext aufgenommen werden soll. Der Ergebniszeilenindex beginnt bei 0. Beispiel: `StFrom = 2 `Überspringt die ersten beiden Ergebniszeilen und gibt Ergebnisse ab der dritten Zeile zurück. Datentyp: Zahl (Ganzzahl) Standard: 0 |
[Tabelle : 2. Abfrageparameter]

{#actsub-GET-activities__entry__26}

| Name | Beschreibung |
|-|-|
| Keine |   |
[Tabelle : 3. Anforderungstext-Parameter (XML oder JSON)]

### Header

Die folgenden Anforderungs- und Antwort-Header gelten nur für diese HTTP-Aktion oder werden auf diese Aktion in einer bestimmten Weise angewendet. Eine Liste der allgemeinen Header, die in der REST-API verwendet werden, finden Sie unter [Unterstützte REST-API-Header](https://servicenow-prod.fluidtopics.net/ai2El07oZMsuDDSV75uftQ "REST (repräsentative Statusübertragung) ist eine einfache statuslose Architektur, die Standards zwischen Computersystemen im Web bereitstellt, wodurch sie leichter miteinander kommunizieren können.").
{#actsub-GET-activities__entry__30}{#actsub-GET-activities__accept-RESTAPI}

| Header | Beschreibung |
|-|-|
| Akzeptieren | Datenformat des Antworttexts. Unterstützte Typen: application/jsonOder application/xml. Standard: application/json |
[Tabelle : 4. Anforderungskopfzeilen.]

{#actsub-GET-activities__entry__34}

| Header | Beschreibung |
|-|-|
| Keine |   |
[Tabelle : 5. Antwort-Header]

### Statuscodes

Die folgenden Statuscodes gelten für diese HTTP-Aktion. Eine Liste der möglichen Statuscodes, die in der REST-API verwendet werden, finden Sie unter [REST-API-HTTP-Antwortcodes](https://servicenow-prod.fluidtopics.net/ai2El07oZMsuDDSV75uftQ "REST (repräsentative Statusübertragung) ist eine einfache statuslose Architektur, die Standards zwischen Computersystemen im Web bereitstellt, wodurch sie leichter miteinander kommunizieren können.").
{#actsub-GET-activities__entry__38}{#actsub-GET-activities__entry-200-status-code}{#actsub-GET-activities__entry-400-status-code}{#actsub-GET-activities__entry-401-status-code}{#actsub-GET-activities__entry-500-status-code}

| Statuscode | Beschreibung |
|-|-|
| 200 | Erfolgreich. Die Anforderung wurde erfolgreich verarbeitet. |
| 400 | Ungültige Anforderung. Ein ungültiger Anforderungstyp oder eine fehlerhafte Anforderung wurde erkannt. Der Antworttext result.messageParameter beschreibt die Art des Fehlers. Beispielfehlermeldungen: * Stellen Sie sicher, dass ein gültiger context und context_instance übergeben werden Oder Stellen Sie sicher, dass ein gültiger Stream und ein gültiger Anwender übergeben werden Gibt an, dass der Anforderung eine oder beide fehlt contextUnd context_instanceAbfrageparameter. Diese Parameter sind erforderlich. * StFrom darf nicht größer als zuletzt sein Gibt an, dass stFromAbfrageparameterwert überschreitet lastAbfrageparameterwert. * Geben Sie Start_date und end_date an Gibt an, dass die Anforderung nur einen der enthält start_dateUnd end_dateAbfrageparameter, die nicht separat verwendet werden können. * Start_date darf nicht vor end_date liegen Gibt an, dass die angegebene start_dateAbfrageparameterwert liegt nach dem angegebenen end_dateAbfrageparameterwert. * Angegebener Kontext ist im System nicht konfiguriert Gibt an, dass contextDer Abfrageparameterwert stellt keinen gültigen Aktivitätskontext dar. * Stellen Sie sicher, dass eine gültige context_instance übergeben wird Gibt an, dass context_instanceDer Abfrageparameterwert stellt keine gültige Instanz des angegebenen Aktivitätskontexts dar. {#actsub-GET-activities__ul_cvl_5c4_ylb} |
| 401 | Nicht autorisiert Die Anwenderanmeldeinformationen sind falsch oder wurden nicht übergeben. |
| 500 | Interner Serverfehler. Beim Verarbeiten der Anforderung ist ein unerwarteter Fehler aufgetreten. Die Antwort enthält zusätzliche Informationen zum Fehler. |
[Tabelle : 6. Statuscodes]

### Antworttext-Parameter (JSON oder XML)

{#actsub-GET-activities__entry__48}

| Name | Beschreibung |
|-|-|
| Ergebnis | Ergebnisobjekt. Datentyp: Objekt "result": { "activities": [Array], "message": "String", "status": Number, "stream": "String", "user": "String" } |
| Ergebnis.Aktivitäten | Array von Objekten, in denen jedes Objekt einen Aktivitätsdatensatz aus dem angegebenen Aktivitätskontext und der angegebenen Kontextinstanz darstellt. Datentyp: Array von Objekten "activities": [ { "activity_type_id": "String", "content_fields": [Array], "created": "String", "icon": "String", "source_table_name": "String", "subheader_fields": [Array], "subobject_sys_id": "String", "subobject_table_name": "String", "sys_id": "String", "title": "String" } ] |
| Ergebnis.Aktivitäten.Aktivität_Typ_ID | SYS_ID des Datensatzes aus der Tabelle „Aktivitätstypen" \[sn_actsub_activity_type\], der dem Typ dieses Aktivitätsdatensatzes entspricht. Datentyp: Zeichenfolge |
| Ergebnis.Aktivitäten.Content_Fields | Array von Objekten, in denen jedes Objekt ein Feld darstellt, das als Inhalt in der Kachel für den Aktivitätsdatensatz angezeigt werden soll. Datentyp: Array von Objekten "content_fields": [ { "deeplink_to_subobject": "String", "display_as_timeago": "String", "label": "String", "show_label": "String", "type": "String", "value": "String" } ] |
| result.activities.content_fields.deeplink_to_subobject | Kennzeichnung, die angibt, ob das Inhaltsfeld als Hyperlink zum Datensatz für das Objekt angezeigt wird, für das diese Aktivität ausgeführt wurde. Gültige Werte: * Wahr: Das Inhaltsfeld wird als Hyperlink zum Datensatz für das Objekt angezeigt, für das diese Aktivität ausgeführt wurde. * Falsch: Das Inhaltsfeld wird als Hyperlink zum Datensatz für das Objekt angezeigt, für das diese Aktivität ausgeführt wurde. {#actsub-GET-activities__ul_ej4_bj4_ylb} Datentyp: Zeichenfolge |
| result.activities.content_fields.display_as_timeago | Kennzeichnung, die angibt, ob das Inhaltsfeld im Format „vor" angezeigt wird. Gültige Werte: * Wahr: Das Inhaltsfeld wird im Format „vor" angezeigt. * Falsch: Das Inhaltsfeld wird nicht im Format „vor" angezeigt. {#actsub-GET-activities__ul_kj4_bj4_ylb} Datentyp: Zeichenfolge |
| Ergebnis.Aktivitäten.Content_fields.label | Bezeichnung für das Inhaltsfeld. Datentyp: Zeichenfolge |
| Ergebnis.Aktivitäten.Content_fields.Show_label | Kennzeichnung, die angibt, ob die Inhaltsfeldbezeichnung für Inhaltsfeldwerte in der Kachel für diesen Aktivitätsdatensatz angezeigt wird. Gültige Werte: * Wahr: Die Inhaltsfeldbezeichnung wird für Inhaltsfeldwerte in der Kachel für diesen Aktivitätsdatensatz angezeigt. * Falsch: Die Inhaltsfeldbezeichnung wird für Inhaltsfeldwerte in der Kachel für diesen Aktivitätsdatensatz nicht angezeigt. {#actsub-GET-activities__ul_sj4_bj4_ylb} Datentyp: Zeichenfolge |
| Ergebnis.Aktivitäten.Inhalt_Felder.Typ | Typ des Inhaltsfelds. Datentyp: Zeichenfolge |
| Ergebnis.Aktivitäten.Inhalt_Felder.Wert | Wert des Inhaltsfelds. Datentyp: Zeichenfolge |
| Ergebnis.Aktivitäten.erstellt | Erstellungsdatum/-Uhrzeit für diesen Aktivitätsdatensatz. Datentyp: Zeichenfolge Format: JJJJ-TT-MM hh:mm:ss |
| Ergebnis.Aktivitäten.Symbol | Name des Symbols, das auf der Kachel für diesen Aktivitätsdatensatz angezeigt wird. Datentyp: Zeichenfolge |
| Ergebnis.Aktivitäten.Quelle_Tabellenname | Name der Tabelle, in der sich dieser Aktivitätsdatensatz befindet. Bestimmt durch die Aktivitätsquelle, die in der Tabelle „Aktivitätstypen" \[sn_actsub_activity_type\] für den Typ definiert ist, der diesem Aktivitätsdatensatz zugeordnet ist. Datentyp: Zeichenfolge |
| Ergebnis.Aktivitäten.subHeader_fields | Array von Objekten, in denen jedes Objekt ein Feld darstellt, das im Unterheader der Kachel für diesen Aktivitätsdatensatz angezeigt wird. Datentyp: Array von Objekten "subheader_fields": [ { "deeplink_to_subobject": "String", "display_as_timeago": "String", "label": "String", "show_label": "String", "type": "String", "value": "String" } ] |
| result.activities.subheader_fields.deeplink_to_subobject | Kennzeichnung, die angibt, ob das Subheader-Feld als Hyperlink zum Datensatz für das Objekt angezeigt wird, für das diese Aktivität ausgeführt wurde. Gültige Werte: * Wahr: Das Feld „Unterheader" wird als Hyperlink zum Datensatz für das Objekt angezeigt, für das diese Aktivität ausgeführt wurde. * Falsch: Das Feld „Subheader" wird nicht als Hyperlink zum Datensatz für das Objekt angezeigt, für das diese Aktivität ausgeführt wurde. {#actsub-GET-activities__ul_ppz_534_ylb} Datentyp: Zeichenfolge |
| result.activities.subheader_fields.display_as_timeago | Kennzeichnung, die angibt, ob das Subheader-Feld im Format „Time ago" angezeigt wird. Gültige Werte: * Wahr: Das Feld „Subheader" wird im Format „vor" angezeigt. * Falsch: Das Feld „Subheader" wird nicht im Format „Time ago" angezeigt. {#actsub-GET-activities__ul_oqv_y34_ylb} Datentyp: Zeichenfolge |
| Ergebnis.Aktivitäten.subHeader_fields.label | Bezeichnung für das Subheader-Feld. Datentyp: Zeichenfolge |
| Ergebnis.Aktivitäten.subHeader_fields.Show_label | Kennzeichnung, die angibt, ob die Bezeichnung des Subheader-Felds für Subheader-Feldwerte in der Kachel für diesen Aktivitätsdatensatz angezeigt wird. Gültige Werte: * Wahr: Die Feldbezeichnung des Unterheaders wird für Subheader-Feldwerte in der Kachel für diesen Aktivitätsdatensatz angezeigt. * Falsch: Die Feldbezeichnung des Unterheaders wird für Subheader-Feldwerte in der Kachel für diesen Aktivitätsdatensatz nicht angezeigt. {#actsub-GET-activities__ul_iws_q34_ylb} Datentyp: Zeichenfolge |
| Ergebnis.Aktivitäten.subHeader_fields.type | Typ des Subheader-Felds. Datentyp: Zeichenfolge |
| Ergebnis.Aktivitäten.subHeader_fields.value | Wert des Subheader-Felds. Datentyp: Zeichenfolge |
| Ergebnis.Aktivitäten.subobject_sys_ID | SYS_ID des Datensatzes für das Objekt, für das diese Aktivität ausgeführt wurde. Befindet sich in der Tabelle, die in angegeben ist subobject_table_nameParameterwert. Datentyp: Zeichenfolge |
| Ergebnis.Aktivitäten.subobject_table_Name | Name der Tabelle, die den Datensatz für das Objekt enthält, für das diese Aktivität ausgeführt wurde. Bestimmt durch den Tabellennamen, der in der Tabelle „Aktivitätsgruppe" \[sn_actsub_subscribable_object\] für die Gruppe definiert ist, die den Aktivitätstyp enthält, der diesem Aktivitätsdatensatz zugeordnet ist. Datentyp: Zeichenfolge |
| Ergebnis.Aktivitäten.sys_ID | SYS_ID dieses Aktivitätsdatensatzes. Befindet sich in der Tabelle, die als angegeben ist source_table_nameParameterwert des Antworttexts. Datentyp: Zeichenfolge |
| Ergebnis.Aktivitäten.Titel | Titel, der auf der Kachel für diesen Aktivitätsdatensatz angezeigt wird. Datentyp: Zeichenfolge |
| Ergebnis.hasMoreDatensätze | Kennzeichnung, die angibt, ob die Liste der Aktivitäten im Antworttext von gekürzt wird lastAbfrageparameterwert. Gültige Werte: * Wahr: Die Liste der Aktivitäten im Antworttext wird durch gekürzt lastAbfrageparameterwert. Anforderung wird mit einem höheren wiederholt lastDer Abfrageparameterwert gibt zusätzliche Aktivitäten für diesen Kontext und diese Kontextinstanz zurück. * Falsch: Die Liste der Aktivitäten im Antworttext wird nicht durch gekürzt lastAbfrageparameterwert. Für diesen Kontext und diese Kontextinstanz sind keine weiteren Aktivitäten verfügbar. {#actsub-GET-activities__ul_x24_sf4_ylb} Datentyp: Zeichenfolge |
| Ergebnis.Nachricht | Fehlermeldung, die das während der Anforderungsverarbeitung aufgetretene Problem beschreibt. Datentyp: Zeichenfolge |
| Ergebnis.Status | HTTP-Statuscode für Anforderung zurückgegeben. Gültige Werte: Siehe Statuscodes. Datentyp: Zahl |
| Ergebnis.Stream | In Anforderung angegebene SYS_ID contextAbfrageparameter. Datentyp: Zeichenfolge Tabelle: Aktivitätskontext \[sn_actsub_activity_context\] |
| result.user | In Anforderung angegebene SYS_ID context_instanceAbfrageparameter. Befindet sich in der entsprechenden Tabelle für den Aktivitätskontext. Datentyp: Zeichenfolge |
[ ]

### Curl-Anforderung

Fordern Sie den zweiten und dritten Aktivitätsdatensatz für einen bestimmten Kontakt an, wobei Sie auf Daten von 2020 beschränken:

    curl "https://instance.servicenow.com/api/now/actsub/activities\
    ?context=4a6a035a73d30010e37d71ef64f6a714\
    &context_instance=ddce70866f9331003b3c498f5d3ee417\
    &stFrom=1&last=3\
    &start_date=2020-01-01%2000:00:00&end_date=2020-12-31%2023:59:59" \
    --request GET \
    --header "Accept: application/json" \
    --user "username:password"

Der Antworttext enthält die beiden angeforderten Aktivitätsdatensätze für den angegebenen Kontakt:

    {
      "result": {
        "hasMoreRecords": true,
        "activities": [
          {
            "subobject_table_name": "sn_customerservice_case",
            "source_table_name": "sn_customerservice_case",
            "content_fields": [
              {
                "value": "Test",
                "show_label": "false",
                "type": "string",
                "label": "Short description",
                "display_as_timeago": "false",
                "deeplink_to_subobject": "false"
              }
            ],
            "created": "2020-05-29 18:42:16",
            "activity_type_id": "baf0aace73530010e37d71ef64f6a748",
            "title": "Lamar Wilson created case",
            "subobject_sys_id": "1687360e8d819010f87705a074e52ac9",
            "icon": "clipboard_outline",
            "sys_id": "1687360e8d819010f87705a074e52ac9",
            "subheader_fields": [
              {
                "value": "CS0001007",
                "show_label": "false",
                "type": "string",
                "label": "Number",
                "display_as_timeago": "false",
                "deeplink_to_subobject": "true"
              },
              {
                "value": "2020-05-29 18:42:16",
                "show_label": "false",
                "type": "glide_date_time",
                "label": "Created",
                "display_as_timeago": "true",
                "deeplink_to_subobject": "false"
              },
              {
                "value": "",
                "show_label": "false",
                "type": "reference",
                "label": "Assigned to",
                "display_as_timeago": "false",
                "deeplink_to_subobject": "false"
              },
              {
                "value": "Lamar Wilson",
                "show_label": "false",
                "type": "reference",
                "label": "Contact",
                "display_as_timeago": "false",
                "deeplink_to_subobject": "false"
              }
            ]
          },
          {
            "subobject_table_name": "kb_knowledge",
            "source_table_name": "kb_use",
            "content_fields": [
              {
                "value": "How to Set Up a Broadband Router",
                "show_label": "false",
                "type": "string",
                "label": "Short description",
                "display_as_timeago": "false",
                "deeplink_to_subobject": "false"
              }
            ],
            "created": "2020-05-26 10:00:00",
            "activity_type_id": "4a8c329273d30010e37d71ef64f6a7c1",
            "title": "Lamar Wilson viewed knowledge article",
            "subobject_sys_id": "f855a0a89f011200550bf7b6077fcf4f",
            "icon": "document_outline",
            "sys_id": "b929dd5873941010e37d71ef64f6a719",
            "subheader_fields": [
              {
                "value": "KB0000110",
                "show_label": "false",
                "type": "string",
                "label": "Number",
                "display_as_timeago": "false",
                "deeplink_to_subobject": "true"
              },
              {
                "value": "2020-05-26 10:00:00",
                "show_label": "false",
                "type": "glide_date_time",
                "label": "Created",
                "display_as_timeago": "true",
                "deeplink_to_subobject": "false"
              }
            ]
          }
        ]
      }
    }

## Aktivitätsabonnements -- GET /now/actsub/facets/{activity_context}/{context_instance} {#ariaid-title3}

Ruft Aspekte ab, die für einen Aktivitätskontext aus den Abonnements und dem Aktivitäts-Feed-Framework konfiguriert sind. Zeigt Aktivitätsanzahlen und -Daten für jeden Aspekt an, wie durch Aktivitätstyp, Gruppe und Kontexteinstellungen bestimmt.
Anwender müssen über die Rolle „actsub_user" oder „admin" verfügen, um auf diesen Endpunkt zuzugreifen. Die zurückgegebenen Daten werden durch Anwenderzugriffseinstellungen eingeschränkt.

Weitere Informationen zu Aktivitätskontextaspekten finden Sie unter [Erstellen Sie Aspekte für Aktivitätskontexte](https://www.servicenow.com/docs/access?context=create-facet-customer-central&version=yokohama&pubname=yokohama-customer-service-management&ft:locale=en-US).

### URL-Format

Versionierte URL: /api/now/{api_Version}/actsub/facets/{activity_context}/{context_instance}

Standard-URL: /api/now/actsub/facets/{activity_context}/{context_instance}  
Hinweis:  
Verfügbare Versionen werden in angegeben [REST-API-Explorer](https://servicenow-prod.fluidtopics.net/QZyr9s_~V0xB9fqGOlvJ4A "In diesem Tutorial verwenden Sie den REST API Explorer, um zu testen ServiceNowREST-APIs."). Für geskriptete REST-APIs gibt es zusätzliche Versionsinformationen auf [Geskriptetes REST-Service-Formular](https://servicenow-prod.fluidtopics.net/0V9QfkPsOI5r~YAD7CJWCA "Mit der geskripteten REST-API-Funktion können Anwendungsentwickler anwenderdefinierte Webservice-APIs erstellen.").

### Unterstützte Anforderungsparameter

{#actsub-GET-facets__entry__2}{#actsub-GET-facets__version-not_optional-RESTAPI}

| Name | Beschreibung |
|-|-|
| Activity_context | SYS_ID eines Aktivitätskontexts. Vordefinierte Aktivitätskontexte umfassen Verbraucher und Kontakt. Navigieren zu KundenzentraleKundenaktivitätAktivitätskontexte Um die vollständige Liste der für Ihre Instanz definierten Aktivitätskontexte anzuzeigen. Datentyp: Zeichenfolge Tabelle: Aktivitätskontexte \[sn_actsub_activity_context\] |
| api_version | Optional. Version des Endpunkts, auf den zugegriffen werden soll. Beispiel: <kbd class="ph userinput">v1 </kbd>Oder <kbd class="ph userinput">v2 </kbd>. Geben Sie diesen Wert nur an, um eine andere Endpunktversion als die neueste zu verwenden. Datentyp: Zeichenfolge |
| Context_instance | SYS_ID einer Instanz des angegebenen Aktivitätskontexts, die den Initiator der Aktivitäten darstellt, für die Sie Aspekte abrufen möchten. Beispiel: Wenn Sie festlegen activity_contextAuf die sys_ID des Kontaktaktivitätskontexts setzen Sie diesen Parameter auf die sys_ID des Kontakts \[Customer_contact\] für den Kontakt, dessen Aktivitätsaspekte Sie abrufen möchten. Datentyp: Zeichenfolge Tabelle: In der Kontexttabelle, die für den Aktivitätskontextdatensatz in der Tabelle „Aktivitätskontexte" \[sn_actsub_activity_context\] angegeben ist. |
[Tabelle : 7. Pfad-Parameter]

{#actsub-GET-facets__entry__10}{#actsub-GET-facets__end-date-query-param-entry}{#actsub-GET-facets__start-date-query-param-entry}

| Name | Beschreibung |
|-|-|
| end_date | Datums-/Uhrzeitwert. Die Anforderung gibt nur Datensätze zurück, die während des von definierten Zeitraums erstellt wurden start_dateUnd diesen Parameter. Muss zusammen mit festgelegt werden start_date. Datentyp: Zeichenfolge Format: JJJJ-MM-TT hh:mm:ss oder JJJJ-MM-TT |
| Aspekte | Kommagetrennte Liste von sys_IDs von Aktivitätsaspekten, die für den angegebenen Aktivitätskontext abgerufen werden sollen. Navigieren Sie zu, um die für einen Aktivitätskontext definierten Aktivitätsaspekttypen anzuzeigen KundenzentraleKundenaktivitätAktivitätskontexte Und überprüfen Sie Aspekte Zugehörige Liste. Datentyp: Zeichenfolge Standard: Gibt alle Aktivitätsaspekte zurück, die für den Aktivitätskontext konfiguriert sind. |
| Get_activity_count | Kennzeichnung, die angibt, ob die Aktivitätsanzahlen für jeden Aspekt in den Antworttext aufgenommen werden sollen. Gültige Werte: * Wahr: Anzahlen der Facettenaktivität einschließen. * Falsch: Anzahlen der Facettenaktivität auslassen. {#actsub-GET-facets__ul_zw1_y5n_ylb} Datentyp: Boolescher Wert Standard: Falsch |
| Lazy_load | Kennzeichnung, die angibt, ob die Leistung durch Auslassen von Aspektaktivitätsdaten und Aktivitätsanzahlen aus dem Antworttext verbessert werden soll. Dieser Parameter hat Vorrang vor get_activity_count. Gültige Werte: * Wahr: Aspektaktivitätsdaten und Aktivitätsanzahlen auslassen. * Falsch: Ruft Aspektaktivitätsdaten und Aktivitätsanzahlen ab. {#actsub-GET-facets__ul_ph3_kvn_ylb} Datentyp: Boolescher Wert Standard: Falsch |
| start_date | Datums-/Uhrzeitwert. Die Anforderung gibt nur Datensätze zurück, die während des durch diesen Parameter und definierten Zeitraums erstellt wurden end_date. Muss zusammen mit festgelegt werden end_date. Datentyp: Zeichenfolge Format: JJJJ-MM-TT hh:mm:ss oder JJJJ-MM-TT |
[Tabelle : 8. Abfrageparameter]

{#actsub-GET-facets__entry__22}

| Name | Beschreibung |
|-|-|
| Keine |   |
[Tabelle : 9. Anforderungstext-Parameter (XML oder JSON)]

### Header

Die folgenden Anforderungs- und Antwort-Header gelten nur für diese HTTP-Aktion oder werden auf diese Aktion in einer bestimmten Weise angewendet. Eine Liste der allgemeinen Header, die in der REST-API verwendet werden, finden Sie unter [Unterstützte REST-API-Header](https://servicenow-prod.fluidtopics.net/ai2El07oZMsuDDSV75uftQ "REST (repräsentative Statusübertragung) ist eine einfache statuslose Architektur, die Standards zwischen Computersystemen im Web bereitstellt, wodurch sie leichter miteinander kommunizieren können.").
{#actsub-GET-facets__entry__26}{#actsub-GET-facets__accept-RESTAPI}

| Header | Beschreibung |
|-|-|
| Akzeptieren | Datenformat des Antworttexts. Unterstützte Typen: application/jsonOder application/xml. Standard: application/json |
[Tabelle : 10. Anforderungskopfzeilen.]

{#actsub-GET-facets__entry__30}

| Header | Beschreibung |
|-|-|
| Keine |   |
[Tabelle : 11. Antwort-Header]

### Statuscodes

Die folgenden Statuscodes gelten für diese HTTP-Aktion. Eine Liste der möglichen Statuscodes, die in der REST-API verwendet werden, finden Sie unter [REST-API-HTTP-Antwortcodes](https://servicenow-prod.fluidtopics.net/ai2El07oZMsuDDSV75uftQ "REST (repräsentative Statusübertragung) ist eine einfache statuslose Architektur, die Standards zwischen Computersystemen im Web bereitstellt, wodurch sie leichter miteinander kommunizieren können.").
{#actsub-GET-facets__entry__34}{#actsub-GET-facets__entry-200-status-code}{#actsub-GET-facets__entry-400-status-code}{#actsub-GET-facets__entry-401-status-code}{#actsub-GET-facets__entry-500-status-code}

| Statuscode | Beschreibung |
|-|-|
| 200 | Erfolgreich. Die Anforderung wurde erfolgreich verarbeitet. |
| 400 | Ungültige Anforderung. Ein ungültiger Anforderungstyp oder eine fehlerhafte Anforderung wurde erkannt. Der Antworttext result.messageParameter beschreibt die Art des Fehlers. Beispielfehlermeldungen: * Stellen Sie sicher, dass gültige Aktivitätskontextdetails übergeben werden Gibt an, dass activity_contextDer Pfadparameterwert stellt keinen gültigen Aktivitätskontext dar context_instanceDer Pfadparameterwert stellt keine gültige Instanz des angegebenen Aktivitätskontexts oder beides dar. * Geben Sie Start_date und end_date an Gibt an, dass die Anforderung nur einen der enthält start_dateUnd end_dateAbfrageparameter, die nicht separat verwendet werden können. * Start_date darf nicht vor end_date liegen Gibt an, dass die angegebene start_dateAbfrageparameterwert liegt nach dem angegebenen end_dateAbfrageparameterwert. {#actsub-GET-facets__ul_cvl_5c4_ylb} |
| 401 | Nicht autorisiert Die Anwenderanmeldeinformationen sind falsch oder wurden nicht übergeben. |
| 500 | Interner Serverfehler. Beim Verarbeiten der Anforderung ist ein unerwarteter Fehler aufgetreten. Die Antwort enthält zusätzliche Informationen zum Fehler. |
[Tabelle : 12. Statuscodes]

### Antworttext-Parameter (JSON oder XML)

{#actsub-GET-facets__entry__44}

| Name | Beschreibung |
|-|-|
| Ergebnis | Liste der Aktivitätsaspekte. Datentyp: Array von Objekten "result": [ { "activity_count": Number, "children": [Array], "facets": [Array], "icon": "String", "is_dynamic": "String", "message": "String", "name": "String", "status": Number } ] |
| Ergebnis.Activity_count | Anzahl der in diesem Aspekt enthaltenen Aktivitätsdatensätze (und ihrer untergeordneten Elemente, falls vorhanden. Wird nur angezeigt, wenn lazy_loadAbfrageparameter ist „falsch" und get_activity_countAbfrageparameter ist „wahr". Datentyp: Zahl |
| result.children | Array von Objekten, in denen jedes Objekt einen Aktivitätsdatensatz (wenn dies ein dynamischer Aspekt ist) oder einen untergeordneten Aspekt (wenn dies ein statischer Aspekt ist) darstellt. Datentyp: Array von Objekten "children": [ { "activity_count": Number "facet": "String", "icon": "String", "title": "String" } ] |
| result.children.activity_count | Anzahl der Aktivitätsdatensätze, die in diesem untergeordneten Aspekt enthalten sind (und seine untergeordneten Elemente, falls vorhanden). Wird nur angezeigt, wenn lazy_loadAbfrageparameter ist „falsch" und „falsch" get_activity_countAbfrageparameter ist „wahr". Datentyp: Zahl |
| result.children.created | Erstellungsdatum/-Uhrzeit für diesen Aktivitätsdatensatz. Datentyp: Zeichenfolge Format: JJJJ-MM-TT hh:mm:ss |
| result.children.facet | SYS_ID dieses untergeordneten Aspektdatensatzes. Datentyp: Zeichenfolge Tabelle: Aktivitätsaspekt \[sn_actsub_facet\] |
| result.children.icon | Name des Symbols, das diesem untergeordneten Aspekt zugeordnet ist. Datentyp: Zeichenfolge |
| result.children.sys_id | SYS_ID dieses Aktivitätsdatensatzes. Befindet sich in der entsprechenden Tabelle für den übergeordneten Aspekttyp. Beispiel: Ein Aktivitätsdatensatz, der im Fallaspekt enthalten ist, hat eine sys_ID in der Tabelle „Fall" \[sn_customerservice_Case\]. Datentyp: Zeichenfolge |
| result.children.metadata | Array von Objekten, in denen jedes Objekt Aktivitätsdatensatzdaten für ein Aspektfeld enthält, das im Datensatz der Tabelle „Aktivitätsaspekt" \[sn_actsub_facet\] für diesen Aspekttyp konfiguriert ist. Datentyp: Array von Objekten "metadata": [ { "key": "String", "label": "String", "type": "String", "value": "String" } ] |
| result.children.metadata.key | Name dieses Aspektfelds. Datentyp: Zeichenfolge |
| result.children.metadata.label | Bezeichnung dieses Aspektfelds. Datentyp: Zeichenfolge |
| result.children.metadata.type | Typ dieses Aspektfelds. Datentyp: Zeichenfolge |
| result.children.metadata.value | Wert dieses Aspektfelds. Datentyp: Zeichenfolge |
| result.children.title | Name dieses Aktivitätsdatensatzes oder untergeordneten Aspekts. Datentyp: Zeichenfolge |
| Ergebnis.Aspekte | Liste der sys_IDs, die diesem Aspektdatensatz zugeordnet sind. Für einen dynamischen Aspekt enthält dieses Array die sys_ID des Aspekts selbst. Für einen statischen Aspekt enthält es stattdessen die sys_IDs aller Aspekte, die untergeordnete Elemente des Aspekts sind. Datentyp: Array "facets": [ "510d7e2e73570010e37d71ef64f6a70d", "bc9bfaaa73570010e37d71ef64f6a771" ] Tabelle: Aktivitätsaspekt \[sn_actsub_facet\] |
| Ergebnis.Symbol | Name des diesem Aspekt zugeordneten Symbols. Datentyp: Zeichenfolge |
| Result.is_Dynamic | Kennzeichnung, die angibt, ob dieser Aspekt ein dynamischer Aspekt ist. Dieser Wert bestimmt die Art der Informationen, die in enthalten sind childrenAntworttext-Parameter. Mögliche Werte: * Wahr: Dies ist ein dynamischer Aspekt. Die childrenDer Parameterwert für den Antworttext enthält Aktivitätsdatensatzdetails und facetsParameter enthält den dynamischen Aspekt sys_ID * Falsch: Dies ist ein statischer Aspekt (eine Aspektgruppe). Die childrenDer Parameterwert des Antworttexts enthält untergeordnete Aspekte und facetsParameter enthält die sys_IDs dieser untergeordneten Aspekte. {#actsub-GET-facets__ul_atr_gnv_ylb} Datentyp: Boolescher Wert |
| Ergebnis.Nachricht | Fehlermeldung, die das während der Anforderungsverarbeitung aufgetretene Problem beschreibt. Datentyp: Zeichenfolge |
| result.name | Name des Aspekts oder der Aspektgruppe. Datentyp: Zeichenfolge |
| Ergebnis.Status | HTTP-Statuscode für Anforderung zurückgegeben. Mögliche Werte: Siehe Statuscode-Tabelle. Datentyp: Zahl |
[ ]

### Curl-Anforderung

Ruft Aspekte und Aktivitätsanzahlen von Chats, Telefonen und Wissensartikeln für einen Kontakt ab:

    curl "https://instance.servicenow.com/api/now/actsub/facets/4a6a035a73d30010e37d71ef64f6a714/ddce70866f9331003b3c498f5d3ee417\
    ?get_activity_count=true\
    &facets=510d7e2e73570010e37d71ef64f6a70d,bc9bfaaa73570010e37d71ef64f6a771,c72d7e2e73570010e37d71ef64f6a7b8" \
    --request GET \
    --header "Accept: application/json" \
    --user "username:password"

Der Antworttext enthält die drei angeforderten Aspekte als untergeordnete Elemente ihrer Aspektgruppen, wobei die Aktivitätsanzahlen angezeigt werden:

    {
      "result": [
        {
          "is_dynamic": false,
          "name": "Interactions",
          "activity_count": 4.0,
          "facets": [
            "510d7e2e73570010e37d71ef64f6a70d",
            "bc9bfaaa73570010e37d71ef64f6a771"
          ],
          "children": [
            {
              "facet": "510d7e2e73570010e37d71ef64f6a70d",
              "icon": "chat_outline",
              "activity_count": 2.0,
              "title": "Chat"
            },
            {
              "facet": "bc9bfaaa73570010e37d71ef64f6a771",
              "icon": "phone_outline",
              "activity_count": 2.0,
              "title": "Phone"
            }
          ]
        },
        {
          "is_dynamic": false,
          "name": "Portal Activity",
          "activity_count": 5.0,
          "facets": [
            "c72d7e2e73570010e37d71ef64f6a7b8"
          ],
          "children": [
            {
              "facet": "c72d7e2e73570010e37d71ef64f6a7b8",
              "icon": "document_outline",
              "activity_count": 5.0,
              "title": "Knowledge articles"
            }
          ]
        }
      ]
    }


