egain-api-python 0.1.2__py3-none-any.whl → 0.1.3__py3-none-any.whl
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- egain_api_python/_version.py +3 -3
- egain_api_python/answers.py +18 -18
- egain_api_python/articlelists.py +6 -6
- egain_api_python/errors/gethealthop.py +33 -19
- egain_api_python/export.py +2 -2
- egain_api_python/models/__init__.py +65 -42
- egain_api_python/models/aisearchop.py +6 -34
- egain_api_python/models/aisearchresponse.py +0 -4
- egain_api_python/models/articleaisearchresult.py +14 -21
- egain_api_python/models/articletype.py +3 -5
- egain_api_python/models/exportstatus.py +15 -8
- egain_api_python/models/getannouncementarticlesop.py +2 -2
- egain_api_python/models/getarticlelistdetailsop.py +2 -2
- egain_api_python/models/getarticlesintopicop.py +4 -4
- egain_api_python/models/getbestanswerop.py +6 -6
- egain_api_python/models/gethealthop.py +134 -7
- egain_api_python/models/getpopulararticlesop.py +4 -4
- egain_api_python/models/getrelatedarticlesop.py +2 -2
- egain_api_python/models/importstatus.py +116 -0
- egain_api_python/models/knowledgeexport.py +3 -5
- egain_api_python/models/referenceresponse.py +7 -23
- egain_api_python/models/retrievechunksop.py +6 -6
- egain_api_python/models/searchresult.py +7 -23
- egain_api_python/populararticles.py +12 -12
- egain_api_python/portal_article.py +24 -24
- egain_api_python/retrieve.py +18 -18
- egain_api_python/sdk.py +1 -0
- egain_api_python/search.py +18 -36
- {egain_api_python-0.1.2.dist-info → egain_api_python-0.1.3.dist-info}/METADATA +14 -9
- {egain_api_python-0.1.2.dist-info → egain_api_python-0.1.3.dist-info}/RECORD +33 -35
- egain_api_python/models/resourcetype_parameter.py +0 -10
- egain_api_python/models/topicaisearchresult.py +0 -67
- {egain_api_python-0.1.2.dist-info → egain_api_python-0.1.3.dist-info}/WHEEL +0 -0
- {egain_api_python-0.1.2.dist-info → egain_api_python-0.1.3.dist-info}/licenses/LICENSE +0 -0
- {egain_api_python-0.1.2.dist-info → egain_api_python-0.1.3.dist-info}/top_level.txt +0 -0
@@ -1,6 +1,7 @@
|
|
1
1
|
"""Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT."""
|
2
2
|
|
3
3
|
from __future__ import annotations
|
4
|
+
from datetime import datetime
|
4
5
|
from egain_api_python.types import BaseModel
|
5
6
|
import pydantic
|
6
7
|
from typing import Literal, Optional
|
@@ -14,16 +15,131 @@ ImportStatusStatus = Literal[
|
|
14
15
|
"Failed",
|
15
16
|
"Cancelled",
|
16
17
|
]
|
18
|
+
r"""Status of the job."""
|
19
|
+
|
20
|
+
|
21
|
+
JobType = Literal[
|
22
|
+
"Import",
|
23
|
+
"Validation",
|
24
|
+
]
|
25
|
+
|
26
|
+
|
27
|
+
class ImportStatusProgressTypedDict(TypedDict):
|
28
|
+
r"""Progress of the job."""
|
29
|
+
|
30
|
+
processed: NotRequired[float]
|
31
|
+
r"""Number of items processed."""
|
32
|
+
total: NotRequired[float]
|
33
|
+
r"""Number of total items to process."""
|
34
|
+
percentage: NotRequired[float]
|
35
|
+
r"""Percentage of total items that have been processed."""
|
36
|
+
|
37
|
+
|
38
|
+
class ImportStatusProgress(BaseModel):
|
39
|
+
r"""Progress of the job."""
|
40
|
+
|
41
|
+
processed: Optional[float] = None
|
42
|
+
r"""Number of items processed."""
|
43
|
+
|
44
|
+
total: Optional[float] = None
|
45
|
+
r"""Number of total items to process."""
|
46
|
+
|
47
|
+
percentage: Optional[float] = None
|
48
|
+
r"""Percentage of total items that have been processed."""
|
49
|
+
|
50
|
+
|
51
|
+
class ImportStatusResultsTypedDict(TypedDict):
|
52
|
+
r"""Result of job."""
|
53
|
+
|
54
|
+
succesfull: NotRequired[float]
|
55
|
+
r"""Number of item succesfully processed by job."""
|
56
|
+
warnings: NotRequired[float]
|
57
|
+
r"""Number of warnings encountered during job."""
|
58
|
+
errors: NotRequired[float]
|
59
|
+
r"""Number of errors encountered during job."""
|
60
|
+
|
61
|
+
|
62
|
+
class ImportStatusResults(BaseModel):
|
63
|
+
r"""Result of job."""
|
64
|
+
|
65
|
+
succesfull: Optional[float] = None
|
66
|
+
r"""Number of item succesfully processed by job."""
|
67
|
+
|
68
|
+
warnings: Optional[float] = None
|
69
|
+
r"""Number of warnings encountered during job."""
|
70
|
+
|
71
|
+
errors: Optional[float] = None
|
72
|
+
r"""Number of errors encountered during job."""
|
17
73
|
|
18
74
|
|
19
75
|
class ImportStatusTypedDict(TypedDict):
|
20
76
|
status: ImportStatusStatus
|
77
|
+
r"""Status of the job."""
|
78
|
+
job_type: JobType
|
79
|
+
progress: NotRequired[ImportStatusProgressTypedDict]
|
80
|
+
r"""Progress of the job."""
|
21
81
|
log_file_location: NotRequired[str]
|
82
|
+
r"""Location of the job log file."""
|
83
|
+
start_time: NotRequired[datetime]
|
84
|
+
r"""Start time of job."""
|
85
|
+
estimated_completion: NotRequired[datetime]
|
86
|
+
r"""Estimated completion time of job."""
|
87
|
+
current_operation: NotRequired[str]
|
88
|
+
r"""Current operation of job being processed."""
|
89
|
+
completion_time: NotRequired[datetime]
|
90
|
+
r"""Completion time of job."""
|
91
|
+
failure_time: NotRequired[datetime]
|
92
|
+
r"""Failure time of job."""
|
93
|
+
results: NotRequired[ImportStatusResultsTypedDict]
|
94
|
+
r"""Result of job."""
|
95
|
+
error: NotRequired[str]
|
96
|
+
r"""Error of job."""
|
97
|
+
retryable: NotRequired[bool]
|
98
|
+
r"""Indicates if job is retryable."""
|
22
99
|
|
23
100
|
|
24
101
|
class ImportStatus(BaseModel):
|
25
102
|
status: ImportStatusStatus
|
103
|
+
r"""Status of the job."""
|
104
|
+
|
105
|
+
job_type: Annotated[JobType, pydantic.Field(alias="jobType")]
|
106
|
+
|
107
|
+
progress: Optional[ImportStatusProgress] = None
|
108
|
+
r"""Progress of the job."""
|
26
109
|
|
27
110
|
log_file_location: Annotated[
|
28
111
|
Optional[str], pydantic.Field(alias="logFileLocation")
|
29
112
|
] = None
|
113
|
+
r"""Location of the job log file."""
|
114
|
+
|
115
|
+
start_time: Annotated[Optional[datetime], pydantic.Field(alias="startTime")] = None
|
116
|
+
r"""Start time of job."""
|
117
|
+
|
118
|
+
estimated_completion: Annotated[
|
119
|
+
Optional[datetime], pydantic.Field(alias="estimatedCompletion")
|
120
|
+
] = None
|
121
|
+
r"""Estimated completion time of job."""
|
122
|
+
|
123
|
+
current_operation: Annotated[
|
124
|
+
Optional[str], pydantic.Field(alias="currentOperation")
|
125
|
+
] = None
|
126
|
+
r"""Current operation of job being processed."""
|
127
|
+
|
128
|
+
completion_time: Annotated[
|
129
|
+
Optional[datetime], pydantic.Field(alias="completionTime")
|
130
|
+
] = None
|
131
|
+
r"""Completion time of job."""
|
132
|
+
|
133
|
+
failure_time: Annotated[Optional[datetime], pydantic.Field(alias="failureTime")] = (
|
134
|
+
None
|
135
|
+
)
|
136
|
+
r"""Failure time of job."""
|
137
|
+
|
138
|
+
results: Optional[ImportStatusResults] = None
|
139
|
+
r"""Result of job."""
|
140
|
+
|
141
|
+
error: Optional[str] = None
|
142
|
+
r"""Error of job."""
|
143
|
+
|
144
|
+
retryable: Optional[bool] = None
|
145
|
+
r"""Indicates if job is retryable."""
|
@@ -48,7 +48,7 @@ class KnowledgeExportLanguage(BaseModel):
|
|
48
48
|
r"""The code of the language."""
|
49
49
|
|
50
50
|
|
51
|
-
|
51
|
+
ResourceType = Literal[
|
52
52
|
"articles",
|
53
53
|
"topics",
|
54
54
|
"portals",
|
@@ -104,7 +104,7 @@ class KnowledgeExportTypedDict(TypedDict):
|
|
104
104
|
r"""The ID of the portal being accessed.<br><br>A portal ID is composed of a 2-4 letter prefix, followed by a dash and 4-15 digits."""
|
105
105
|
language: KnowledgeExportLanguageTypedDict
|
106
106
|
r"""The Knowledge Base language in which the content is created."""
|
107
|
-
resource_types: List[
|
107
|
+
resource_types: List[ResourceType]
|
108
108
|
r"""Types of Knowledge Hub resources to export. Multiple values can be specified using a comma-separated list. Details of a single portal are exported.
|
109
109
|
Articles whose state is Published are returned.
|
110
110
|
| Portal Attribute Name | Description
|
@@ -170,9 +170,7 @@ class KnowledgeExport(BaseModel):
|
|
170
170
|
language: KnowledgeExportLanguage
|
171
171
|
r"""The Knowledge Base language in which the content is created."""
|
172
172
|
|
173
|
-
resource_types: Annotated[
|
174
|
-
List[KnowledgeExportResourceType], pydantic.Field(alias="resourceTypes")
|
175
|
-
]
|
173
|
+
resource_types: Annotated[List[ResourceType], pydantic.Field(alias="resourceTypes")]
|
176
174
|
r"""Types of Knowledge Hub resources to export. Multiple values can be specified using a comma-separated list. Details of a single portal are exported.
|
177
175
|
Articles whose state is Published are returned.
|
178
176
|
| Portal Attribute Name | Description
|
@@ -1,6 +1,7 @@
|
|
1
1
|
"""Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT."""
|
2
2
|
|
3
3
|
from __future__ import annotations
|
4
|
+
from .topicbreadcrumb import TopicBreadcrumb, TopicBreadcrumbTypedDict
|
4
5
|
from egain_api_python.types import BaseModel
|
5
6
|
import pydantic
|
6
7
|
from typing import Literal, Optional
|
@@ -22,25 +23,6 @@ ReferenceResponseSource = Literal[
|
|
22
23
|
r"""Source Type"""
|
23
24
|
|
24
25
|
|
25
|
-
class ReferenceResponseLinkTypedDict(TypedDict):
|
26
|
-
r"""Defines the relationship between this resource and another object."""
|
27
|
-
|
28
|
-
rel: NotRequired[str]
|
29
|
-
r"""Defines the relationship between a linked resource and the current object. <br><br> For example: self, prev, next or an object name such as 'user', 'folder' etc."""
|
30
|
-
href: NotRequired[str]
|
31
|
-
r"""The URL that specifies the link's destination."""
|
32
|
-
|
33
|
-
|
34
|
-
class ReferenceResponseLink(BaseModel):
|
35
|
-
r"""Defines the relationship between this resource and another object."""
|
36
|
-
|
37
|
-
rel: Optional[str] = None
|
38
|
-
r"""Defines the relationship between a linked resource and the current object. <br><br> For example: self, prev, next or an object name such as 'user', 'folder' etc."""
|
39
|
-
|
40
|
-
href: Optional[str] = None
|
41
|
-
r"""The URL that specifies the link's destination."""
|
42
|
-
|
43
|
-
|
44
26
|
class ReferenceResponseTypedDict(TypedDict):
|
45
27
|
r"""One document used in generated response"""
|
46
28
|
|
@@ -54,8 +36,8 @@ class ReferenceResponseTypedDict(TypedDict):
|
|
54
36
|
r"""Source Type"""
|
55
37
|
doc_name: NotRequired[str]
|
56
38
|
r"""Name of the attachment, if an attachment was used as the source content."""
|
57
|
-
|
58
|
-
r"""
|
39
|
+
topic_bread_crumb: NotRequired[TopicBreadcrumbTypedDict]
|
40
|
+
r"""This schema contains one or more TopicSummary instances."""
|
59
41
|
|
60
42
|
|
61
43
|
class ReferenceResponse(BaseModel):
|
@@ -76,5 +58,7 @@ class ReferenceResponse(BaseModel):
|
|
76
58
|
doc_name: Annotated[Optional[str], pydantic.Field(alias="docName")] = None
|
77
59
|
r"""Name of the attachment, if an attachment was used as the source content."""
|
78
60
|
|
79
|
-
|
80
|
-
|
61
|
+
topic_bread_crumb: Annotated[
|
62
|
+
Optional[TopicBreadcrumb], pydantic.Field(alias="topicBreadCrumb")
|
63
|
+
] = None
|
64
|
+
r"""This schema contains one or more TopicSummary instances."""
|
@@ -26,15 +26,15 @@ class RetrieveChunksRequestTypedDict(TypedDict):
|
|
26
26
|
r"""The search query string. The string must be escaped as required by the URL syntax rules."""
|
27
27
|
portal_id: str
|
28
28
|
r"""The ID of the portal being accessed.<br><br>A portal ID is composed of a 2-4 letter prefix, followed by a dash and 4-15 digits."""
|
29
|
-
|
29
|
+
filter_user_profile_id: NotRequired[str]
|
30
30
|
language: NotRequired[LanguageCodeParameter]
|
31
31
|
r"""The language that describes the details of a resource. Resources available in different languages may differ from each other. <br><br> If lang is not passed, then the portal's default language is used."""
|
32
|
-
|
32
|
+
filter_tags: NotRequired[Dict[str, List[str]]]
|
33
33
|
r"""An object where each key is a **Category Tag ID** (numeric string),
|
34
34
|
and each value is an array of **Tag IDs** for that category.
|
35
35
|
|
36
36
|
"""
|
37
|
-
|
37
|
+
filter_topic_ids: NotRequired[List[str]]
|
38
38
|
r"""An array of topic IDs. It is used to restrict search results to specific topics."""
|
39
39
|
retrieve_request: NotRequired[RetrieveRequestTypedDict]
|
40
40
|
|
@@ -52,7 +52,7 @@ class RetrieveChunksRequest(BaseModel):
|
|
52
52
|
]
|
53
53
|
r"""The ID of the portal being accessed.<br><br>A portal ID is composed of a 2-4 letter prefix, followed by a dash and 4-15 digits."""
|
54
54
|
|
55
|
-
|
55
|
+
filter_user_profile_id: Annotated[
|
56
56
|
Optional[str],
|
57
57
|
pydantic.Field(alias="$filter[userProfileID]"),
|
58
58
|
FieldMetadata(query=QueryParamMetadata(style="form", explode=True)),
|
@@ -65,7 +65,7 @@ class RetrieveChunksRequest(BaseModel):
|
|
65
65
|
] = None
|
66
66
|
r"""The language that describes the details of a resource. Resources available in different languages may differ from each other. <br><br> If lang is not passed, then the portal's default language is used."""
|
67
67
|
|
68
|
-
|
68
|
+
filter_tags: Annotated[
|
69
69
|
Optional[Dict[str, List[str]]],
|
70
70
|
pydantic.Field(alias="$filter[tags]"),
|
71
71
|
FieldMetadata(query=QueryParamMetadata(style="form", explode=True)),
|
@@ -75,7 +75,7 @@ class RetrieveChunksRequest(BaseModel):
|
|
75
75
|
|
76
76
|
"""
|
77
77
|
|
78
|
-
|
78
|
+
filter_topic_ids: Annotated[
|
79
79
|
Optional[List[str]],
|
80
80
|
pydantic.Field(alias="$filter[topicIds]"),
|
81
81
|
FieldMetadata(query=QueryParamMetadata(style="form", explode=True)),
|
@@ -1,6 +1,7 @@
|
|
1
1
|
"""Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT."""
|
2
2
|
|
3
3
|
from __future__ import annotations
|
4
|
+
from .topicbreadcrumb import TopicBreadcrumb, TopicBreadcrumbTypedDict
|
4
5
|
from egain_api_python.types import BaseModel
|
5
6
|
import pydantic
|
6
7
|
from typing import Literal, Optional
|
@@ -28,25 +29,6 @@ SnippetType = Literal[
|
|
28
29
|
]
|
29
30
|
|
30
31
|
|
31
|
-
class SearchResultLinkTypedDict(TypedDict):
|
32
|
-
r"""Defines the relationship between this resource and another object."""
|
33
|
-
|
34
|
-
rel: NotRequired[str]
|
35
|
-
r"""Defines the relationship between a linked resource and the current object. <br><br> For example: self, prev, next or an object name such as 'user', 'folder' etc."""
|
36
|
-
href: NotRequired[str]
|
37
|
-
r"""The URL that specifies the link's destination."""
|
38
|
-
|
39
|
-
|
40
|
-
class SearchResultLink(BaseModel):
|
41
|
-
r"""Defines the relationship between this resource and another object."""
|
42
|
-
|
43
|
-
rel: Optional[str] = None
|
44
|
-
r"""Defines the relationship between a linked resource and the current object. <br><br> For example: self, prev, next or an object name such as 'user', 'folder' etc."""
|
45
|
-
|
46
|
-
href: Optional[str] = None
|
47
|
-
r"""The URL that specifies the link's destination."""
|
48
|
-
|
49
|
-
|
50
32
|
class SearchResultTypedDict(TypedDict):
|
51
33
|
r"""Represents a single document or snippet returned by search, along with its metadata and relevance score."""
|
52
34
|
|
@@ -65,8 +47,8 @@ class SearchResultTypedDict(TypedDict):
|
|
65
47
|
doc_name: NotRequired[str]
|
66
48
|
r"""Name of the attachment, if an attachment was used as the source content."""
|
67
49
|
snippet_type: NotRequired[SnippetType]
|
68
|
-
|
69
|
-
r"""
|
50
|
+
topic_bread_crumb: NotRequired[TopicBreadcrumbTypedDict]
|
51
|
+
r"""This schema contains one or more TopicSummary instances."""
|
70
52
|
|
71
53
|
|
72
54
|
class SearchResult(BaseModel):
|
@@ -97,5 +79,7 @@ class SearchResult(BaseModel):
|
|
97
79
|
Optional[SnippetType], pydantic.Field(alias="snippetType")
|
98
80
|
] = None
|
99
81
|
|
100
|
-
|
101
|
-
|
82
|
+
topic_bread_crumb: Annotated[
|
83
|
+
Optional[TopicBreadcrumb], pydantic.Field(alias="topicBreadCrumb")
|
84
|
+
] = None
|
85
|
+
r"""This schema contains one or more TopicSummary instances."""
|
@@ -15,9 +15,9 @@ class Populararticles(BaseSDK):
|
|
15
15
|
*,
|
16
16
|
accept_language: models.AcceptLanguage,
|
17
17
|
portal_id: str,
|
18
|
-
|
18
|
+
filter_topic_id: Optional[str] = None,
|
19
19
|
language: Optional[models.LanguageQueryParameter] = None,
|
20
|
-
|
20
|
+
filter_tags: Optional[str] = None,
|
21
21
|
pagenum: Optional[int] = 1,
|
22
22
|
pagesize: Optional[int] = 10,
|
23
23
|
article_result_additional_attributes: Optional[
|
@@ -51,9 +51,9 @@ class Populararticles(BaseSDK):
|
|
51
51
|
|
52
52
|
:param accept_language: The Language locale accepted by the client (used for locale specific fields in resource representation and in error responses).
|
53
53
|
:param portal_id: The ID of the portal being accessed.<br><br>A portal ID is composed of a 2-4 letter prefix, followed by a dash and 4-15 digits.
|
54
|
-
:param
|
54
|
+
:param filter_topic_id: The ID of the topic. It is used to restrict to a specific topic.
|
55
55
|
:param language: The language that describes the details of a resource. Resources available in different languages may differ from each other.<li>If <code>lang</code> is not passed, then the portal's default language is used.</li>
|
56
|
-
:param
|
56
|
+
:param filter_tags: A comma separated list of Tag / Tag Group IDs. The query results will be filtered by the tags that are specified.<br><br>Tag IDs and Tag Group IDs can be mixed together.
|
57
57
|
:param pagenum: Pagination parameter that specifies the page number of results to be returned. Used in conjunction with $pagesize.
|
58
58
|
:param pagesize: Pagination parameter that specifies the number of results per page. Used in conjunction with $pagenum.
|
59
59
|
:param article_result_additional_attributes: The attributes of an Article to be returned *in addition to* the default list of attributes, listed below. Multiple additional attributes can be specified using a comma-separated list. Passing 'all' will return all attributes. #### Default Attributes These Article attributes are always returned: | Name | Description | ---- | ----------- | id | The ID of the Article. | name | The name of the Article. | articleType | The Article Type and its attributes. | createdBy | The ID, first name, middle name and last name of the user that created the Article. | createdDate | The date that the Article was created. | hasAttachments | True: The Article has one or more attachments.<br>False: The Article does not have any attachments. | languageCode | The language code of the Article language. | modifiedBy | The ID, first name, middle name and last name of the user that last modified the Article. | modifiedDate | The date that the Article was last modified on. | link | The link object, used to retrieve the details of the Article. | versionId | The ID of the Article version that is returned.
|
@@ -75,9 +75,9 @@ class Populararticles(BaseSDK):
|
|
75
75
|
request = models.GetpopulararticlesRequest(
|
76
76
|
accept_language=accept_language,
|
77
77
|
portal_id=portal_id,
|
78
|
-
|
78
|
+
filter_topic_id=filter_topic_id,
|
79
79
|
language=language,
|
80
|
-
|
80
|
+
filter_tags=filter_tags,
|
81
81
|
pagenum=pagenum,
|
82
82
|
pagesize=pagesize,
|
83
83
|
article_result_additional_attributes=article_result_additional_attributes,
|
@@ -153,9 +153,9 @@ class Populararticles(BaseSDK):
|
|
153
153
|
*,
|
154
154
|
accept_language: models.AcceptLanguage,
|
155
155
|
portal_id: str,
|
156
|
-
|
156
|
+
filter_topic_id: Optional[str] = None,
|
157
157
|
language: Optional[models.LanguageQueryParameter] = None,
|
158
|
-
|
158
|
+
filter_tags: Optional[str] = None,
|
159
159
|
pagenum: Optional[int] = 1,
|
160
160
|
pagesize: Optional[int] = 10,
|
161
161
|
article_result_additional_attributes: Optional[
|
@@ -189,9 +189,9 @@ class Populararticles(BaseSDK):
|
|
189
189
|
|
190
190
|
:param accept_language: The Language locale accepted by the client (used for locale specific fields in resource representation and in error responses).
|
191
191
|
:param portal_id: The ID of the portal being accessed.<br><br>A portal ID is composed of a 2-4 letter prefix, followed by a dash and 4-15 digits.
|
192
|
-
:param
|
192
|
+
:param filter_topic_id: The ID of the topic. It is used to restrict to a specific topic.
|
193
193
|
:param language: The language that describes the details of a resource. Resources available in different languages may differ from each other.<li>If <code>lang</code> is not passed, then the portal's default language is used.</li>
|
194
|
-
:param
|
194
|
+
:param filter_tags: A comma separated list of Tag / Tag Group IDs. The query results will be filtered by the tags that are specified.<br><br>Tag IDs and Tag Group IDs can be mixed together.
|
195
195
|
:param pagenum: Pagination parameter that specifies the page number of results to be returned. Used in conjunction with $pagesize.
|
196
196
|
:param pagesize: Pagination parameter that specifies the number of results per page. Used in conjunction with $pagenum.
|
197
197
|
:param article_result_additional_attributes: The attributes of an Article to be returned *in addition to* the default list of attributes, listed below. Multiple additional attributes can be specified using a comma-separated list. Passing 'all' will return all attributes. #### Default Attributes These Article attributes are always returned: | Name | Description | ---- | ----------- | id | The ID of the Article. | name | The name of the Article. | articleType | The Article Type and its attributes. | createdBy | The ID, first name, middle name and last name of the user that created the Article. | createdDate | The date that the Article was created. | hasAttachments | True: The Article has one or more attachments.<br>False: The Article does not have any attachments. | languageCode | The language code of the Article language. | modifiedBy | The ID, first name, middle name and last name of the user that last modified the Article. | modifiedDate | The date that the Article was last modified on. | link | The link object, used to retrieve the details of the Article. | versionId | The ID of the Article version that is returned.
|
@@ -213,9 +213,9 @@ class Populararticles(BaseSDK):
|
|
213
213
|
request = models.GetpopulararticlesRequest(
|
214
214
|
accept_language=accept_language,
|
215
215
|
portal_id=portal_id,
|
216
|
-
|
216
|
+
filter_topic_id=filter_topic_id,
|
217
217
|
language=language,
|
218
|
-
|
218
|
+
filter_tags=filter_tags,
|
219
219
|
pagenum=pagenum,
|
220
220
|
pagesize=pagesize,
|
221
221
|
article_result_additional_attributes=article_result_additional_attributes,
|
@@ -1299,12 +1299,12 @@ class PortalArticle(BaseSDK):
|
|
1299
1299
|
*,
|
1300
1300
|
accept_language: models.AcceptLanguage,
|
1301
1301
|
portal_id: str,
|
1302
|
-
|
1302
|
+
filter_topic_id: str,
|
1303
1303
|
search_profile_id: Optional[str] = None,
|
1304
1304
|
article_result_additional_attributes: Optional[
|
1305
1305
|
List[models.ArticleResultAdditionalAttributes]
|
1306
1306
|
] = None,
|
1307
|
-
|
1307
|
+
filter_tags: Optional[str] = None,
|
1308
1308
|
workflow_milestone: Optional[models.WorkflowMilestone] = None,
|
1309
1309
|
language: Optional[models.LanguageQueryParameter] = None,
|
1310
1310
|
pagenum: Optional[int] = 1,
|
@@ -1342,10 +1342,10 @@ class PortalArticle(BaseSDK):
|
|
1342
1342
|
|
1343
1343
|
:param accept_language: The Language locale accepted by the client (used for locale specific fields in resource representation and in error responses).
|
1344
1344
|
:param portal_id: The ID of the portal being accessed.<br><br>A portal ID is composed of a 2-4 letter prefix, followed by a dash and 4-15 digits.
|
1345
|
-
:param
|
1345
|
+
:param filter_topic_id: The ID of the topic. It is used to restrict to a specific topic.
|
1346
1346
|
:param search_profile_id: Search Profile ID
|
1347
1347
|
:param article_result_additional_attributes: The attributes of an Article to be returned *in addition to* the default list of attributes, listed below. Multiple additional attributes can be specified using a comma-separated list. Passing 'all' will return all attributes. #### Default Attributes These Article attributes are always returned: | Name | Description | ---- | ----------- | id | The ID of the Article. | name | The name of the Article. | articleType | The Article Type and its attributes. | createdBy | The ID, first name, middle name and last name of the user that created the Article. | createdDate | The date that the Article was created. | hasAttachments | True: The Article has one or more attachments.<br>False: The Article does not have any attachments. | languageCode | The language code of the Article language. | modifiedBy | The ID, first name, middle name and last name of the user that last modified the Article. | modifiedDate | The date that the Article was last modified on. | link | The link object, used to retrieve the details of the Article. | versionId | The ID of the Article version that is returned.
|
1348
|
-
:param
|
1348
|
+
:param filter_tags: A comma separated list of Tag / Tag Group IDs. The query results will be filtered by the tags that are specified.<br><br>Tag IDs and Tag Group IDs can be mixed together.
|
1349
1349
|
:param workflow_milestone: For agents with the View Author Portal or View Staging Portal actions, this determines which version of the Article is returned.<li>'Authoring' returns the most recent version of an Article checked-in by an author.</li><li>'Staging' returns the updated version currently being processed in a workflow.</li><li>'Publish' returns the most recently published version.</li>
|
1350
1350
|
:param language: The language that describes the details of a resource. Resources available in different languages may differ from each other.<li>If <code>lang</code> is not passed, then the portal's default language is used.</li>
|
1351
1351
|
:param pagenum: Pagination parameter that specifies the page number of results to be returned. Used in conjunction with $pagesize.
|
@@ -1371,9 +1371,9 @@ class PortalArticle(BaseSDK):
|
|
1371
1371
|
accept_language=accept_language,
|
1372
1372
|
portal_id=portal_id,
|
1373
1373
|
search_profile_id=search_profile_id,
|
1374
|
-
|
1374
|
+
filter_topic_id=filter_topic_id,
|
1375
1375
|
article_result_additional_attributes=article_result_additional_attributes,
|
1376
|
-
|
1376
|
+
filter_tags=filter_tags,
|
1377
1377
|
workflow_milestone=workflow_milestone,
|
1378
1378
|
language=language,
|
1379
1379
|
pagenum=pagenum,
|
@@ -1452,12 +1452,12 @@ class PortalArticle(BaseSDK):
|
|
1452
1452
|
*,
|
1453
1453
|
accept_language: models.AcceptLanguage,
|
1454
1454
|
portal_id: str,
|
1455
|
-
|
1455
|
+
filter_topic_id: str,
|
1456
1456
|
search_profile_id: Optional[str] = None,
|
1457
1457
|
article_result_additional_attributes: Optional[
|
1458
1458
|
List[models.ArticleResultAdditionalAttributes]
|
1459
1459
|
] = None,
|
1460
|
-
|
1460
|
+
filter_tags: Optional[str] = None,
|
1461
1461
|
workflow_milestone: Optional[models.WorkflowMilestone] = None,
|
1462
1462
|
language: Optional[models.LanguageQueryParameter] = None,
|
1463
1463
|
pagenum: Optional[int] = 1,
|
@@ -1495,10 +1495,10 @@ class PortalArticle(BaseSDK):
|
|
1495
1495
|
|
1496
1496
|
:param accept_language: The Language locale accepted by the client (used for locale specific fields in resource representation and in error responses).
|
1497
1497
|
:param portal_id: The ID of the portal being accessed.<br><br>A portal ID is composed of a 2-4 letter prefix, followed by a dash and 4-15 digits.
|
1498
|
-
:param
|
1498
|
+
:param filter_topic_id: The ID of the topic. It is used to restrict to a specific topic.
|
1499
1499
|
:param search_profile_id: Search Profile ID
|
1500
1500
|
:param article_result_additional_attributes: The attributes of an Article to be returned *in addition to* the default list of attributes, listed below. Multiple additional attributes can be specified using a comma-separated list. Passing 'all' will return all attributes. #### Default Attributes These Article attributes are always returned: | Name | Description | ---- | ----------- | id | The ID of the Article. | name | The name of the Article. | articleType | The Article Type and its attributes. | createdBy | The ID, first name, middle name and last name of the user that created the Article. | createdDate | The date that the Article was created. | hasAttachments | True: The Article has one or more attachments.<br>False: The Article does not have any attachments. | languageCode | The language code of the Article language. | modifiedBy | The ID, first name, middle name and last name of the user that last modified the Article. | modifiedDate | The date that the Article was last modified on. | link | The link object, used to retrieve the details of the Article. | versionId | The ID of the Article version that is returned.
|
1501
|
-
:param
|
1501
|
+
:param filter_tags: A comma separated list of Tag / Tag Group IDs. The query results will be filtered by the tags that are specified.<br><br>Tag IDs and Tag Group IDs can be mixed together.
|
1502
1502
|
:param workflow_milestone: For agents with the View Author Portal or View Staging Portal actions, this determines which version of the Article is returned.<li>'Authoring' returns the most recent version of an Article checked-in by an author.</li><li>'Staging' returns the updated version currently being processed in a workflow.</li><li>'Publish' returns the most recently published version.</li>
|
1503
1503
|
:param language: The language that describes the details of a resource. Resources available in different languages may differ from each other.<li>If <code>lang</code> is not passed, then the portal's default language is used.</li>
|
1504
1504
|
:param pagenum: Pagination parameter that specifies the page number of results to be returned. Used in conjunction with $pagesize.
|
@@ -1524,9 +1524,9 @@ class PortalArticle(BaseSDK):
|
|
1524
1524
|
accept_language=accept_language,
|
1525
1525
|
portal_id=portal_id,
|
1526
1526
|
search_profile_id=search_profile_id,
|
1527
|
-
|
1527
|
+
filter_topic_id=filter_topic_id,
|
1528
1528
|
article_result_additional_attributes=article_result_additional_attributes,
|
1529
|
-
|
1529
|
+
filter_tags=filter_tags,
|
1530
1530
|
workflow_milestone=workflow_milestone,
|
1531
1531
|
language=language,
|
1532
1532
|
pagenum=pagenum,
|
@@ -2026,7 +2026,7 @@ class PortalArticle(BaseSDK):
|
|
2026
2026
|
accept_language: models.AcceptLanguage,
|
2027
2027
|
portal_id: str,
|
2028
2028
|
article_id: str,
|
2029
|
-
|
2029
|
+
filter_tags: Optional[str] = None,
|
2030
2030
|
article_result_additional_attributes: Optional[
|
2031
2031
|
List[models.ArticleResultAdditionalAttributes]
|
2032
2032
|
] = None,
|
@@ -2066,7 +2066,7 @@ class PortalArticle(BaseSDK):
|
|
2066
2066
|
:param accept_language: The Language locale accepted by the client (used for locale specific fields in resource representation and in error responses).
|
2067
2067
|
:param portal_id: The ID of the portal being accessed.<br><br>A portal ID is composed of a 2-4 letter prefix, followed by a dash and 4-15 digits.
|
2068
2068
|
:param article_id: The ID of the Article.<br><br>An Article ID is composed of a 2-4 letter prefix followed by a dash and 4-15 digits.
|
2069
|
-
:param
|
2069
|
+
:param filter_tags: A comma separated list of Tag / Tag Group IDs. The query results will be filtered by the tags that are specified.<br><br>Tag IDs and Tag Group IDs can be mixed together.
|
2070
2070
|
:param article_result_additional_attributes: The attributes of an Article to be returned *in addition to* the default list of attributes, listed below. Multiple additional attributes can be specified using a comma-separated list. Passing 'all' will return all attributes. #### Default Attributes These Article attributes are always returned: | Name | Description | ---- | ----------- | id | The ID of the Article. | name | The name of the Article. | articleType | The Article Type and its attributes. | createdBy | The ID, first name, middle name and last name of the user that created the Article. | createdDate | The date that the Article was created. | hasAttachments | True: The Article has one or more attachments.<br>False: The Article does not have any attachments. | languageCode | The language code of the Article language. | modifiedBy | The ID, first name, middle name and last name of the user that last modified the Article. | modifiedDate | The date that the Article was last modified on. | link | The link object, used to retrieve the details of the Article. | versionId | The ID of the Article version that is returned.
|
2071
2071
|
:param workflow_milestone: For agents with the View Author Portal or View Staging Portal actions, this determines which version of the Article is returned.<li>'Authoring' returns the most recent version of an Article checked-in by an author.</li><li>'Staging' returns the updated version currently being processed in a workflow.</li><li>'Publish' returns the most recently published version.</li>
|
2072
2072
|
:param language: The language that describes the details of a resource. Resources available in different languages may differ from each other.<li>If <code>lang</code> is not passed, then the portal's default language is used.</li>
|
@@ -2091,7 +2091,7 @@ class PortalArticle(BaseSDK):
|
|
2091
2091
|
accept_language=accept_language,
|
2092
2092
|
portal_id=portal_id,
|
2093
2093
|
article_id=article_id,
|
2094
|
-
|
2094
|
+
filter_tags=filter_tags,
|
2095
2095
|
article_result_additional_attributes=article_result_additional_attributes,
|
2096
2096
|
workflow_milestone=workflow_milestone,
|
2097
2097
|
language=language,
|
@@ -2170,7 +2170,7 @@ class PortalArticle(BaseSDK):
|
|
2170
2170
|
accept_language: models.AcceptLanguage,
|
2171
2171
|
portal_id: str,
|
2172
2172
|
article_id: str,
|
2173
|
-
|
2173
|
+
filter_tags: Optional[str] = None,
|
2174
2174
|
article_result_additional_attributes: Optional[
|
2175
2175
|
List[models.ArticleResultAdditionalAttributes]
|
2176
2176
|
] = None,
|
@@ -2210,7 +2210,7 @@ class PortalArticle(BaseSDK):
|
|
2210
2210
|
:param accept_language: The Language locale accepted by the client (used for locale specific fields in resource representation and in error responses).
|
2211
2211
|
:param portal_id: The ID of the portal being accessed.<br><br>A portal ID is composed of a 2-4 letter prefix, followed by a dash and 4-15 digits.
|
2212
2212
|
:param article_id: The ID of the Article.<br><br>An Article ID is composed of a 2-4 letter prefix followed by a dash and 4-15 digits.
|
2213
|
-
:param
|
2213
|
+
:param filter_tags: A comma separated list of Tag / Tag Group IDs. The query results will be filtered by the tags that are specified.<br><br>Tag IDs and Tag Group IDs can be mixed together.
|
2214
2214
|
:param article_result_additional_attributes: The attributes of an Article to be returned *in addition to* the default list of attributes, listed below. Multiple additional attributes can be specified using a comma-separated list. Passing 'all' will return all attributes. #### Default Attributes These Article attributes are always returned: | Name | Description | ---- | ----------- | id | The ID of the Article. | name | The name of the Article. | articleType | The Article Type and its attributes. | createdBy | The ID, first name, middle name and last name of the user that created the Article. | createdDate | The date that the Article was created. | hasAttachments | True: The Article has one or more attachments.<br>False: The Article does not have any attachments. | languageCode | The language code of the Article language. | modifiedBy | The ID, first name, middle name and last name of the user that last modified the Article. | modifiedDate | The date that the Article was last modified on. | link | The link object, used to retrieve the details of the Article. | versionId | The ID of the Article version that is returned.
|
2215
2215
|
:param workflow_milestone: For agents with the View Author Portal or View Staging Portal actions, this determines which version of the Article is returned.<li>'Authoring' returns the most recent version of an Article checked-in by an author.</li><li>'Staging' returns the updated version currently being processed in a workflow.</li><li>'Publish' returns the most recently published version.</li>
|
2216
2216
|
:param language: The language that describes the details of a resource. Resources available in different languages may differ from each other.<li>If <code>lang</code> is not passed, then the portal's default language is used.</li>
|
@@ -2235,7 +2235,7 @@ class PortalArticle(BaseSDK):
|
|
2235
2235
|
accept_language=accept_language,
|
2236
2236
|
portal_id=portal_id,
|
2237
2237
|
article_id=article_id,
|
2238
|
-
|
2238
|
+
filter_tags=filter_tags,
|
2239
2239
|
article_result_additional_attributes=article_result_additional_attributes,
|
2240
2240
|
workflow_milestone=workflow_milestone,
|
2241
2241
|
language=language,
|
@@ -2313,7 +2313,7 @@ class PortalArticle(BaseSDK):
|
|
2313
2313
|
*,
|
2314
2314
|
accept_language: models.AcceptLanguage,
|
2315
2315
|
portal_id: str,
|
2316
|
-
|
2316
|
+
filter_tags: Optional[str] = None,
|
2317
2317
|
article_result_additional_attributes: Optional[
|
2318
2318
|
List[models.ArticleResultAdditionalAttributes]
|
2319
2319
|
] = None,
|
@@ -2353,7 +2353,7 @@ class PortalArticle(BaseSDK):
|
|
2353
2353
|
|
2354
2354
|
:param accept_language: The Language locale accepted by the client (used for locale specific fields in resource representation and in error responses).
|
2355
2355
|
:param portal_id: The ID of the portal being accessed.<br><br>A portal ID is composed of a 2-4 letter prefix, followed by a dash and 4-15 digits.
|
2356
|
-
:param
|
2356
|
+
:param filter_tags: A comma separated list of Tag / Tag Group IDs. The query results will be filtered by the tags that are specified.<br><br>Tag IDs and Tag Group IDs can be mixed together.
|
2357
2357
|
:param article_result_additional_attributes: The attributes of an Article to be returned *in addition to* the default list of attributes, listed below. Multiple additional attributes can be specified using a comma-separated list. Passing 'all' will return all attributes. #### Default Attributes These Article attributes are always returned: | Name | Description | ---- | ----------- | id | The ID of the Article. | name | The name of the Article. | articleType | The Article Type and its attributes. | createdBy | The ID, first name, middle name and last name of the user that created the Article. | createdDate | The date that the Article was created. | hasAttachments | True: The Article has one or more attachments.<br>False: The Article does not have any attachments. | languageCode | The language code of the Article language. | modifiedBy | The ID, first name, middle name and last name of the user that last modified the Article. | modifiedDate | The date that the Article was last modified on. | link | The link object, used to retrieve the details of the Article. | versionId | The ID of the Article version that is returned.
|
2358
2358
|
:param workflow_milestone: For agents with the View Author Portal or View Staging Portal actions, this determines which version of the Article is returned.<li>'Authoring' returns the most recent version of an Article checked-in by an author.</li><li>'Staging' returns the updated version currently being processed in a workflow.</li><li>'Publish' returns the most recently published version.</li>
|
2359
2359
|
:param language: The language that describes the details of a resource. Resources available in different languages may differ from each other.<li>If <code>lang</code> is not passed, then the portal's default language is used.</li>
|
@@ -2377,7 +2377,7 @@ class PortalArticle(BaseSDK):
|
|
2377
2377
|
request = models.GetAnnouncementArticlesRequest(
|
2378
2378
|
accept_language=accept_language,
|
2379
2379
|
portal_id=portal_id,
|
2380
|
-
|
2380
|
+
filter_tags=filter_tags,
|
2381
2381
|
article_result_additional_attributes=article_result_additional_attributes,
|
2382
2382
|
workflow_milestone=workflow_milestone,
|
2383
2383
|
language=language,
|
@@ -2455,7 +2455,7 @@ class PortalArticle(BaseSDK):
|
|
2455
2455
|
*,
|
2456
2456
|
accept_language: models.AcceptLanguage,
|
2457
2457
|
portal_id: str,
|
2458
|
-
|
2458
|
+
filter_tags: Optional[str] = None,
|
2459
2459
|
article_result_additional_attributes: Optional[
|
2460
2460
|
List[models.ArticleResultAdditionalAttributes]
|
2461
2461
|
] = None,
|
@@ -2495,7 +2495,7 @@ class PortalArticle(BaseSDK):
|
|
2495
2495
|
|
2496
2496
|
:param accept_language: The Language locale accepted by the client (used for locale specific fields in resource representation and in error responses).
|
2497
2497
|
:param portal_id: The ID of the portal being accessed.<br><br>A portal ID is composed of a 2-4 letter prefix, followed by a dash and 4-15 digits.
|
2498
|
-
:param
|
2498
|
+
:param filter_tags: A comma separated list of Tag / Tag Group IDs. The query results will be filtered by the tags that are specified.<br><br>Tag IDs and Tag Group IDs can be mixed together.
|
2499
2499
|
:param article_result_additional_attributes: The attributes of an Article to be returned *in addition to* the default list of attributes, listed below. Multiple additional attributes can be specified using a comma-separated list. Passing 'all' will return all attributes. #### Default Attributes These Article attributes are always returned: | Name | Description | ---- | ----------- | id | The ID of the Article. | name | The name of the Article. | articleType | The Article Type and its attributes. | createdBy | The ID, first name, middle name and last name of the user that created the Article. | createdDate | The date that the Article was created. | hasAttachments | True: The Article has one or more attachments.<br>False: The Article does not have any attachments. | languageCode | The language code of the Article language. | modifiedBy | The ID, first name, middle name and last name of the user that last modified the Article. | modifiedDate | The date that the Article was last modified on. | link | The link object, used to retrieve the details of the Article. | versionId | The ID of the Article version that is returned.
|
2500
2500
|
:param workflow_milestone: For agents with the View Author Portal or View Staging Portal actions, this determines which version of the Article is returned.<li>'Authoring' returns the most recent version of an Article checked-in by an author.</li><li>'Staging' returns the updated version currently being processed in a workflow.</li><li>'Publish' returns the most recently published version.</li>
|
2501
2501
|
:param language: The language that describes the details of a resource. Resources available in different languages may differ from each other.<li>If <code>lang</code> is not passed, then the portal's default language is used.</li>
|
@@ -2519,7 +2519,7 @@ class PortalArticle(BaseSDK):
|
|
2519
2519
|
request = models.GetAnnouncementArticlesRequest(
|
2520
2520
|
accept_language=accept_language,
|
2521
2521
|
portal_id=portal_id,
|
2522
|
-
|
2522
|
+
filter_tags=filter_tags,
|
2523
2523
|
article_result_additional_attributes=article_result_additional_attributes,
|
2524
2524
|
workflow_milestone=workflow_milestone,
|
2525
2525
|
language=language,
|