The Idea Hub API provides endpoints for creators to list and filter their ideas with pagination, record idea activity, update topic state resources, and query which locales ideas are available in for a given property.
List ideas for a given Creator and filter and sort options.
filter(query) — Allows filtering. Supported syntax: * Filter expressions are made up of one or more restrictions. * Restrictions are implicitly combined, as if the `AND` operator was always used. The `OR` operator is currently unsupported. * Supported functions: - `saved(bool)`: If set to true, fetches only saved ideas. If set to false, fetches all except saved ideas. Can't be simultaneously used with `dismissed(bool)`. - `dismissed(bool)`: If set to true, fetches only dismissed ideas. Can't be simultaneously used with `saved(bool)`. The `false` value is currently unsupported. Examples: * `saved(true)` * `saved(false)` * `dismissed(true)` The length of this field should be no more than 500 characters.
orderBy(query) — Order semantics described below.
pageSize(query, limit) — The maximum number of ideas per page. If unspecified, at most 10 ideas will be returned. The maximum value is 2000; values above 2000 will be coerced to 2000.
pageToken(query) — Used to fetch next page.
parent(query) — If defined, specifies the creator for which to filter by. Format: publishers/{publisher}/properties/{property}
PATCH
/v1alpha/{name}
Update a topic state resource.
name(path, required) — Unique identifier for the topic state. Format: platforms/{platform}/properties/{property}/topicStates/{topic_state}
updateMask(query) — The list of fields to be updated.
POST
/v1alpha/{parent}/ideaActivities
Creates an idea activity entry.
parent(path, required) — Required. The parent resource where this idea activity will be created. Format: platforms/{platform}/property/{property}
GET
/v1alpha/{parent}/ideas
List ideas for a given Creator and filter and sort options.
parent(path, required) — If defined, specifies the creator for which to filter by. Format: publishers/{publisher}/properties/{property}
filter(query) — Allows filtering. Supported syntax: * Filter expressions are made up of one or more restrictions. * Restrictions are implicitly combined, as if the `AND` operator was always used. The `OR` operator is currently unsupported. * Supported functions: - `saved(bool)`: If set to true, fetches only saved ideas. If set to false, fetches all except saved ideas. Can't be simultaneously used with `dismissed(bool)`. - `dismissed(bool)`: If set to true, fetches only dismissed ideas. Can't be simultaneously used with `saved(bool)`. The `false` value is currently unsupported. Examples: * `saved(true)` * `saved(false)` * `dismissed(true)` The length of this field should be no more than 500 characters.
orderBy(query) — Order semantics described below.
pageSize(query, limit) — The maximum number of ideas per page. If unspecified, at most 10 ideas will be returned. The maximum value is 2000; values above 2000 will be coerced to 2000.
pageToken(query) — Used to fetch next page.
GET
/v1alpha/{parent}/locales
Returns which locales ideas are available in for a given Creator.
parent(path, required) — Required. The web property to check idea availability for Format: platforms/{platform}/property/{property}
pageSize(query, limit) — The maximum number of locales to return. The service may return fewer than this value. If unspecified, at most 100 locales will be returned. The maximum value is 100; values above 100 will be coerced to 100.
pageToken(query) — A page token, received from a previous `ListAvailableLocales` call. Provide this to retrieve the subsequent page. When paginating, all other parameters provided to `ListAvailableLocales` must match the call that provided the page token.
5 endpoints auto-detected
curl -X GET \
"https://ideahub.googleapis.com/v1alpha/ideas"