# Moderator API . topics

## Instance Methods

Returns the submissions Resource.

Returns the specified topic from the specified series.

Inserts a new topic into the specified series.

Searches the topics within the specified series and returns the search results.

Updates the specified topic within the specified series.

### Method Details

`get(seriesId, topicId)`

    Returns the specified topic from the specified series.

    Args:
      seriesId: integer, The decimal ID of the Series. (required)
      topicId: integer, The decimal ID of the Topic within the Series. (required)

    Returns:
      An object of the form:

        {
          "kind": "moderator#topic",
          "description": "A String",
          "rules": {
            "votes": {
              "close": "A String",
              "open": "A String",
            },
            "submissions": {
              "close": "A String",
              "open": "A String",
            },
          },
          "featuredSubmission": {
              "kind": "moderator#submission",
              "attribution": {
                "displayName": "A String",
                "location": "A String",
                "avatarUrl": "A String",
              },
              "created": "A String",
              "text": "A String",
              "topics": [
                {
                  "id": {
                    "seriesId": "A String",
                    "topicId": "A String",
                  },
                },
              ],
              "author": "A String",
              "translations": [
                {
                  "lang": "A String",
                  "text": "A String",
                },
              ],
              "parentSubmissionId": {
                "seriesId": "A String",
                "submissionId": "A String",
              },
              "vote": {
                "vote": "A String",
                "flag": "A String",
              },
              "attachmentUrl": "A String",
              "geo": {
                "latitude": 3.14,
                "location": "A String",
                "longitude": 3.14,
              },
              "id": {
                "seriesId": "A String",
                "submissionId": "A String",
              },
              "counters": {
                "noneVotes": 42,
                "minusVotes": 42,
                "plusVotes": 42,
              },
            },
          "presenter": "A String",
          "counters": {
            "users": 42,
            "noneVotes": 42,
            "videoSubmissions": 42,
            "minusVotes": 42,
            "submissions": 42,
            "plusVotes": 42,
          },
          "id": {
            "seriesId": "A String",
            "topicId": "A String",
          },
          "name": "A String",
        }

`insert(seriesId, body)`

    Inserts a new topic into the specified series.

    Args:
      seriesId: integer, The decimal ID of the Series. (required)
      body: object, The request body. (required)
        The object takes the form of:

    {
        "kind": "moderator#topic",
        "description": "A String",
        "rules": {
          "votes": {
            "close": "A String",
            "open": "A String",
          },
          "submissions": {
            "close": "A String",
            "open": "A String",
          },
        },
        "featuredSubmission": {
            "kind": "moderator#submission",
            "attribution": {
              "displayName": "A String",
              "location": "A String",
              "avatarUrl": "A String",
            },
            "created": "A String",
            "text": "A String",
            "topics": [
              {
                "id": {
                  "seriesId": "A String",
                  "topicId": "A String",
                },
              },
            ],
            "author": "A String",
            "translations": [
              {
                "lang": "A String",
                "text": "A String",
              },
            ],
            "parentSubmissionId": {
              "seriesId": "A String",
              "submissionId": "A String",
            },
            "vote": {
              "vote": "A String",
              "flag": "A String",
            },
            "attachmentUrl": "A String",
            "geo": {
              "latitude": 3.14,
              "location": "A String",
              "longitude": 3.14,
            },
            "id": {
              "seriesId": "A String",
              "submissionId": "A String",
            },
            "counters": {
              "noneVotes": 42,
              "minusVotes": 42,
              "plusVotes": 42,
            },
          },
        "presenter": "A String",
        "counters": {
          "users": 42,
          "noneVotes": 42,
          "videoSubmissions": 42,
          "minusVotes": 42,
          "submissions": 42,
          "plusVotes": 42,
        },
        "id": {
          "seriesId": "A String",
          "topicId": "A String",
        },
        "name": "A String",
      }

    Returns:
      An object of the form:

        {
          "kind": "moderator#topic",
          "description": "A String",
          "rules": {
            "votes": {
              "close": "A String",
              "open": "A String",
            },
            "submissions": {
              "close": "A String",
              "open": "A String",
            },
          },
          "featuredSubmission": {
              "kind": "moderator#submission",
              "attribution": {
                "displayName": "A String",
                "location": "A String",
                "avatarUrl": "A String",
              },
              "created": "A String",
              "text": "A String",
              "topics": [
                {
                  "id": {
                    "seriesId": "A String",
                    "topicId": "A String",
                  },
                },
              ],
              "author": "A String",
              "translations": [
                {
                  "lang": "A String",
                  "text": "A String",
                },
              ],
              "parentSubmissionId": {
                "seriesId": "A String",
                "submissionId": "A String",
              },
              "vote": {
                "vote": "A String",
                "flag": "A String",
              },
              "attachmentUrl": "A String",
              "geo": {
                "latitude": 3.14,
                "location": "A String",
                "longitude": 3.14,
              },
              "id": {
                "seriesId": "A String",
                "submissionId": "A String",
              },
              "counters": {
                "noneVotes": 42,
                "minusVotes": 42,
                "plusVotes": 42,
              },
            },
          "presenter": "A String",
          "counters": {
            "users": 42,
            "noneVotes": 42,
            "videoSubmissions": 42,
            "minusVotes": 42,
            "submissions": 42,
            "plusVotes": 42,
          },
          "id": {
            "seriesId": "A String",
            "topicId": "A String",
          },
          "name": "A String",
        }

`list(seriesId, q=None, max_results=None, mode=None, start_index=None)`

    Searches the topics within the specified series and returns the search results.

    Args:
      seriesId: integer, The decimal ID of the Series. (required)
      q: string, Search query.
      max_results: integer, Maximum number of results to return.
      mode: string, A parameter
      start_index: integer, Index of the first result to be retrieved.

    Returns:
      An object of the form:

        {
        "items": [
          {
              "kind": "moderator#topic",
              "description": "A String",
              "rules": {
                "votes": {
                  "close": "A String",
                  "open": "A String",
                },
                "submissions": {
                  "close": "A String",
                  "open": "A String",
                },
              },
              "featuredSubmission": {
                  "kind": "moderator#submission",
                  "attribution": {
                    "displayName": "A String",
                    "location": "A String",
                    "avatarUrl": "A String",
                  },
                  "created": "A String",
                  "text": "A String",
                  "topics": [
                    {
                      "id": {
                        "seriesId": "A String",
                        "topicId": "A String",
                      },
                    },
                  ],
                  "author": "A String",
                  "translations": [
                    {
                      "lang": "A String",
                      "text": "A String",
                    },
                  ],
                  "parentSubmissionId": {
                    "seriesId": "A String",
                    "submissionId": "A String",
                  },
                  "vote": {
                    "vote": "A String",
                    "flag": "A String",
                  },
                  "attachmentUrl": "A String",
                  "geo": {
                    "latitude": 3.14,
                    "location": "A String",
                    "longitude": 3.14,
                  },
                  "id": {
                    "seriesId": "A String",
                    "submissionId": "A String",
                  },
                  "counters": {
                    "noneVotes": 42,
                    "minusVotes": 42,
                    "plusVotes": 42,
                  },
                },
              "presenter": "A String",
              "counters": {
                "users": 42,
                "noneVotes": 42,
                "videoSubmissions": 42,
                "minusVotes": 42,
                "submissions": 42,
                "plusVotes": 42,
              },
              "id": {
                "seriesId": "A String",
                "topicId": "A String",
              },
              "name": "A String",
            },
        ],
        "kind": "moderator#topicList",
      }

`update(seriesId, topicId, body)`

    Updates the specified topic within the specified series.

    Args:
      seriesId: integer, The decimal ID of the Series. (required)
      topicId: integer, The decimal ID of the Topic within the Series. (required)
      body: object, The request body. (required)
        The object takes the form of:

    {
        "kind": "moderator#topic",
        "description": "A String",
        "rules": {
          "votes": {
            "close": "A String",
            "open": "A String",
          },
          "submissions": {
            "close": "A String",
            "open": "A String",
          },
        },
        "featuredSubmission": {
            "kind": "moderator#submission",
            "attribution": {
              "displayName": "A String",
              "location": "A String",
              "avatarUrl": "A String",
            },
            "created": "A String",
            "text": "A String",
            "topics": [
              {
                "id": {
                  "seriesId": "A String",
                  "topicId": "A String",
                },
              },
            ],
            "author": "A String",
            "translations": [
              {
                "lang": "A String",
                "text": "A String",
              },
            ],
            "parentSubmissionId": {
              "seriesId": "A String",
              "submissionId": "A String",
            },
            "vote": {
              "vote": "A String",
              "flag": "A String",
            },
            "attachmentUrl": "A String",
            "geo": {
              "latitude": 3.14,
              "location": "A String",
              "longitude": 3.14,
            },
            "id": {
              "seriesId": "A String",
              "submissionId": "A String",
            },
            "counters": {
              "noneVotes": 42,
              "minusVotes": 42,
              "plusVotes": 42,
            },
          },
        "presenter": "A String",
        "counters": {
          "users": 42,
          "noneVotes": 42,
          "videoSubmissions": 42,
          "minusVotes": 42,
          "submissions": 42,
          "plusVotes": 42,
        },
        "id": {
          "seriesId": "A String",
          "topicId": "A String",
        },
        "name": "A String",
      }

    Returns:
      An object of the form:

        {
          "kind": "moderator#topic",
          "description": "A String",
          "rules": {
            "votes": {
              "close": "A String",
              "open": "A String",
            },
            "submissions": {
              "close": "A String",
              "open": "A String",
            },
          },
          "featuredSubmission": {
              "kind": "moderator#submission",
              "attribution": {
                "displayName": "A String",
                "location": "A String",
                "avatarUrl": "A String",
              },
              "created": "A String",
              "text": "A String",
              "topics": [
                {
                  "id": {
                    "seriesId": "A String",
                    "topicId": "A String",
                  },
                },
              ],
              "author": "A String",
              "translations": [
                {
                  "lang": "A String",
                  "text": "A String",
                },
              ],
              "parentSubmissionId": {
                "seriesId": "A String",
                "submissionId": "A String",
              },
              "vote": {
                "vote": "A String",
                "flag": "A String",
              },
              "attachmentUrl": "A String",
              "geo": {
                "latitude": 3.14,
                "location": "A String",
                "longitude": 3.14,
              },
              "id": {
                "seriesId": "A String",
                "submissionId": "A String",
              },
              "counters": {
                "noneVotes": 42,
                "minusVotes": 42,
                "plusVotes": 42,
              },
            },
          "presenter": "A String",
          "counters": {
            "users": 42,
            "noneVotes": 42,
            "videoSubmissions": 42,
            "minusVotes": 42,
            "submissions": 42,
            "plusVotes": 42,
          },
          "id": {
            "seriesId": "A String",
            "topicId": "A String",
          },
          "name": "A String",
        }