Dialogflow API . projects . locations . generators . evaluations

Instance Methods

close()

Close httplib2 connections.

create(parent, body=None, x__xgafv=None)

delete(name, x__xgafv=None)

get(name, x__xgafv=None)

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

list_next()

Retrieves the next page of results.

Method Details

close()
Close httplib2 connections.
create(parent, body=None, x__xgafv=None)

Args:
  parent: string, A parameter (required)
  body: object, The request body.
    The object takes the form of:

{
  "completeTime": "A String",
  "createTime": "A String",
  "displayName": "A String",
  "evaluationStatus": {
    "done": True or False,
    "pipelineStatus": {
      "code": 42,
      "details": [
        {
          "a_key": "", # Properties of the object. Contains field @type with type URL.
        },
      ],
      "message": "A String",
    },
  },
  "generatorEvaluationConfig": {
    "inputDataConfig": {
      "agentAssistInputDataConfig": {
        "endTime": "A String",
        "startTime": "A String",
      },
      "datasetInputDataConfig": {
        "dataset": "A String",
      },
      "endTime": "A String",
      "inputDataSourceType": "A String",
      "isSummaryGenerationAllowed": True or False,
      "sampleSize": 42,
      "startTime": "A String",
      "summaryGenerationOption": "A String",
    },
    "outputGcsBucketPath": "A String",
    "summarizationConfig": {
      "accuracyEvaluationVersion": "A String",
      "completenessEvaluationVersion": "A String",
      "enableAccuracyEvaluation": True or False,
      "enableCompletenessEvaluation": True or False,
      "evaluatorVersion": "A String",
    },
  },
  "initialGenerator": {
    "agentCoachingContext": {
      "instructions": [
        {
          "agentAction": "A String",
          "condition": "A String",
          "displayDetails": "A String",
          "displayName": "A String",
          "duplicateCheckResult": {
            "duplicateSuggestions": [
              {
                "answerRecord": "A String",
                "similarityScore": 3.14,
                "suggestionIndex": 42,
              },
            ],
          },
          "systemAction": "A String",
          "triggeringEvent": "A String",
        },
      ],
      "outputLanguageCode": "A String",
      "overarchingGuidance": "A String",
      "version": "A String",
    },
    "createTime": "A String",
    "description": "A String",
    "freeFormContext": {
      "text": "A String",
    },
    "inferenceParameter": {
      "maxOutputTokens": 42,
      "temperature": 3.14,
      "topK": 42,
      "topP": 3.14,
    },
    "name": "A String",
    "publishedModel": "A String",
    "suggestionDedupingConfig": {
      "enableDeduping": True or False,
      "similarityThreshold": 3.14,
    },
    "summarizationContext": {
      "fewShotExamples": [
        {
          "conversationContext": {
            "messageEntries": [
              {
                "createTime": "A String",
                "languageCode": "A String",
                "role": "A String",
                "text": "A String",
              },
            ],
          },
          "extraInfo": {
            "a_key": "A String",
          },
          "output": {
            "agentCoachingSuggestion": {
              "agentActionSuggestions": [
                {
                  "agentAction": "A String",
                  "duplicateCheckResult": {
                    "duplicateSuggestions": [
                      {
                        "answerRecord": "A String",
                        "similarityScore": 3.14,
                        "sources": {
                          "instructionIndexes": [
                            42,
                          ],
                        },
                        "suggestionIndex": 42,
                      },
                    ],
                  },
                  "sources": {
                    "instructionIndexes": [
                      42,
                    ],
                  },
                },
              ],
              "applicableInstructions": [
                {
                  "agentAction": "A String",
                  "condition": "A String",
                  "displayDetails": "A String",
                  "displayName": "A String",
                  "duplicateCheckResult": {
                    "duplicateSuggestions": [
                      {
                        "answerRecord": "A String",
                        "similarityScore": 3.14,
                        "suggestionIndex": 42,
                      },
                    ],
                  },
                  "systemAction": "A String",
                  "triggeringEvent": "A String",
                },
              ],
              "sampleResponses": [
                {
                  "duplicateCheckResult": {
                    "duplicateSuggestions": [
                      {
                        "answerRecord": "A String",
                        "similarityScore": 3.14,
                        "sources": {
                          "instructionIndexes": [
                            42,
                          ],
                        },
                        "suggestionIndex": 42,
                      },
                    ],
                  },
                  "responseText": "A String",
                  "sources": {
                    "instructionIndexes": [
                      42,
                    ],
                  },
                },
              ],
            },
            "freeFormSuggestion": {
              "response": "A String",
            },
            "summarySuggestion": {
              "summarySections": [
                {
                  "section": "A String",
                  "summary": "A String",
                },
              ],
            },
            "toolCallInfo": [
              {
                "toolCall": {
                  "action": "A String",
                  "answerRecord": "A String",
                  "createTime": "A String",
                  "inputParameters": {
                    "a_key": "", # Properties of the object.
                  },
                  "state": "A String",
                  "tool": "A String",
                  "toolDisplayDetails": "A String",
                  "toolDisplayName": "A String",
                },
                "toolCallResult": {
                  "action": "A String",
                  "answerRecord": "A String",
                  "content": "A String",
                  "createTime": "A String",
                  "error": {
                    "message": "A String",
                  },
                  "rawContent": "A String",
                  "tool": "A String",
                },
              },
            ],
          },
          "summarizationSectionList": {
            "summarizationSections": [
              {
                "definition": "A String",
                "key": "A String",
                "type": "A String",
              },
            ],
          },
        },
      ],
      "outputLanguageCode": "A String",
      "summarizationSections": [
        {
          "definition": "A String",
          "key": "A String",
          "type": "A String",
        },
      ],
      "version": "A String",
    },
    "tools": [
      "A String",
    ],
    "triggerEvent": "A String",
    "updateTime": "A String",
  },
  "name": "A String",
  "satisfiesPzi": True or False,
  "satisfiesPzs": True or False,
  "summarizationMetrics": {
    "conversationDetails": [
      {
        "messageEntries": [
          {
            "createTime": "A String",
            "languageCode": "A String",
            "role": "A String",
            "text": "A String",
          },
        ],
        "metricDetails": [
          {
            "metric": "A String",
            "score": 3.14,
            "sectionDetails": [
              {
                "evaluationResults": [
                  {
                    "accuracyDecomposition": {
                      "accuracyReasoning": "A String",
                      "isAccurate": True or False,
                      "point": "A String",
                    },
                    "adherenceRubric": {
                      "isAddressed": True or False,
                      "question": "A String",
                      "reasoning": "A String",
                    },
                    "completenessRubric": {
                      "isAddressed": True or False,
                      "question": "A String",
                    },
                  },
                ],
                "score": 3.14,
                "section": "A String",
                "sectionSummary": "A String",
              },
            ],
          },
        ],
        "sectionTokens": [
          {
            "section": "A String",
            "tokenCount": "A String",
          },
        ],
        "summarySections": [
          {
            "section": "A String",
            "summary": "A String",
          },
        ],
      },
    ],
    "overallMetrics": [
      {
        "metric": "A String",
      },
    ],
    "overallSectionTokens": [
      {
        "section": "A String",
        "tokenCount": "A String",
      },
    ],
    "summarizationEvaluationMergedResultsUri": "A String",
    "summarizationEvaluationResults": [
      {
        "decompositions": [
          {
            "accuracyDecomposition": {
              "accuracyReasoning": "A String",
              "isAccurate": True or False,
              "point": "A String",
            },
            "adherenceDecomposition": {
              "adherenceReasoning": "A String",
              "isAdherent": True or False,
              "point": "A String",
            },
          },
        ],
        "evaluationResults": [
          {
            "accuracyDecomposition": {
              "accuracyReasoning": "A String",
              "isAccurate": True or False,
              "point": "A String",
            },
            "adherenceRubric": {
              "isAddressed": True or False,
              "question": "A String",
              "reasoning": "A String",
            },
            "completenessRubric": {
              "isAddressed": True or False,
              "question": "A String",
            },
          },
        ],
        "metric": "A String",
        "score": 3.14,
        "section": "A String",
        "sectionSummary": "A String",
        "sessionId": "A String",
      },
    ],
  },
}

  x__xgafv: string, V1 error format.
    Allowed values
      1 - v1 error format
      2 - v2 error format

Returns:
  An object of the form:

    {
  "done": True or False,
  "error": {
    "code": 42,
    "details": [
      {
        "a_key": "", # Properties of the object. Contains field @type with type URL.
      },
    ],
    "message": "A String",
  },
  "metadata": {
    "a_key": "", # Properties of the object. Contains field @type with type URL.
  },
  "name": "A String",
  "response": {
    "a_key": "", # Properties of the object. Contains field @type with type URL.
  },
}
delete(name, x__xgafv=None)

Args:
  name: string, A parameter (required)
  x__xgafv: string, V1 error format.
    Allowed values
      1 - v1 error format
      2 - v2 error format

Returns:
  An object of the form:

    {
}
get(name, x__xgafv=None)

Args:
  name: string, A parameter (required)
  x__xgafv: string, V1 error format.
    Allowed values
      1 - v1 error format
      2 - v2 error format

Returns:
  An object of the form:

    {
  "completeTime": "A String",
  "createTime": "A String",
  "displayName": "A String",
  "evaluationStatus": {
    "done": True or False,
    "pipelineStatus": {
      "code": 42,
      "details": [
        {
          "a_key": "", # Properties of the object. Contains field @type with type URL.
        },
      ],
      "message": "A String",
    },
  },
  "generatorEvaluationConfig": {
    "inputDataConfig": {
      "agentAssistInputDataConfig": {
        "endTime": "A String",
        "startTime": "A String",
      },
      "datasetInputDataConfig": {
        "dataset": "A String",
      },
      "endTime": "A String",
      "inputDataSourceType": "A String",
      "isSummaryGenerationAllowed": True or False,
      "sampleSize": 42,
      "startTime": "A String",
      "summaryGenerationOption": "A String",
    },
    "outputGcsBucketPath": "A String",
    "summarizationConfig": {
      "accuracyEvaluationVersion": "A String",
      "completenessEvaluationVersion": "A String",
      "enableAccuracyEvaluation": True or False,
      "enableCompletenessEvaluation": True or False,
      "evaluatorVersion": "A String",
    },
  },
  "initialGenerator": {
    "agentCoachingContext": {
      "instructions": [
        {
          "agentAction": "A String",
          "condition": "A String",
          "displayDetails": "A String",
          "displayName": "A String",
          "duplicateCheckResult": {
            "duplicateSuggestions": [
              {
                "answerRecord": "A String",
                "similarityScore": 3.14,
                "suggestionIndex": 42,
              },
            ],
          },
          "systemAction": "A String",
          "triggeringEvent": "A String",
        },
      ],
      "outputLanguageCode": "A String",
      "overarchingGuidance": "A String",
      "version": "A String",
    },
    "createTime": "A String",
    "description": "A String",
    "freeFormContext": {
      "text": "A String",
    },
    "inferenceParameter": {
      "maxOutputTokens": 42,
      "temperature": 3.14,
      "topK": 42,
      "topP": 3.14,
    },
    "name": "A String",
    "publishedModel": "A String",
    "suggestionDedupingConfig": {
      "enableDeduping": True or False,
      "similarityThreshold": 3.14,
    },
    "summarizationContext": {
      "fewShotExamples": [
        {
          "conversationContext": {
            "messageEntries": [
              {
                "createTime": "A String",
                "languageCode": "A String",
                "role": "A String",
                "text": "A String",
              },
            ],
          },
          "extraInfo": {
            "a_key": "A String",
          },
          "output": {
            "agentCoachingSuggestion": {
              "agentActionSuggestions": [
                {
                  "agentAction": "A String",
                  "duplicateCheckResult": {
                    "duplicateSuggestions": [
                      {
                        "answerRecord": "A String",
                        "similarityScore": 3.14,
                        "sources": {
                          "instructionIndexes": [
                            42,
                          ],
                        },
                        "suggestionIndex": 42,
                      },
                    ],
                  },
                  "sources": {
                    "instructionIndexes": [
                      42,
                    ],
                  },
                },
              ],
              "applicableInstructions": [
                {
                  "agentAction": "A String",
                  "condition": "A String",
                  "displayDetails": "A String",
                  "displayName": "A String",
                  "duplicateCheckResult": {
                    "duplicateSuggestions": [
                      {
                        "answerRecord": "A String",
                        "similarityScore": 3.14,
                        "suggestionIndex": 42,
                      },
                    ],
                  },
                  "systemAction": "A String",
                  "triggeringEvent": "A String",
                },
              ],
              "sampleResponses": [
                {
                  "duplicateCheckResult": {
                    "duplicateSuggestions": [
                      {
                        "answerRecord": "A String",
                        "similarityScore": 3.14,
                        "sources": {
                          "instructionIndexes": [
                            42,
                          ],
                        },
                        "suggestionIndex": 42,
                      },
                    ],
                  },
                  "responseText": "A String",
                  "sources": {
                    "instructionIndexes": [
                      42,
                    ],
                  },
                },
              ],
            },
            "freeFormSuggestion": {
              "response": "A String",
            },
            "summarySuggestion": {
              "summarySections": [
                {
                  "section": "A String",
                  "summary": "A String",
                },
              ],
            },
            "toolCallInfo": [
              {
                "toolCall": {
                  "action": "A String",
                  "answerRecord": "A String",
                  "createTime": "A String",
                  "inputParameters": {
                    "a_key": "", # Properties of the object.
                  },
                  "state": "A String",
                  "tool": "A String",
                  "toolDisplayDetails": "A String",
                  "toolDisplayName": "A String",
                },
                "toolCallResult": {
                  "action": "A String",
                  "answerRecord": "A String",
                  "content": "A String",
                  "createTime": "A String",
                  "error": {
                    "message": "A String",
                  },
                  "rawContent": "A String",
                  "tool": "A String",
                },
              },
            ],
          },
          "summarizationSectionList": {
            "summarizationSections": [
              {
                "definition": "A String",
                "key": "A String",
                "type": "A String",
              },
            ],
          },
        },
      ],
      "outputLanguageCode": "A String",
      "summarizationSections": [
        {
          "definition": "A String",
          "key": "A String",
          "type": "A String",
        },
      ],
      "version": "A String",
    },
    "tools": [
      "A String",
    ],
    "triggerEvent": "A String",
    "updateTime": "A String",
  },
  "name": "A String",
  "satisfiesPzi": True or False,
  "satisfiesPzs": True or False,
  "summarizationMetrics": {
    "conversationDetails": [
      {
        "messageEntries": [
          {
            "createTime": "A String",
            "languageCode": "A String",
            "role": "A String",
            "text": "A String",
          },
        ],
        "metricDetails": [
          {
            "metric": "A String",
            "score": 3.14,
            "sectionDetails": [
              {
                "evaluationResults": [
                  {
                    "accuracyDecomposition": {
                      "accuracyReasoning": "A String",
                      "isAccurate": True or False,
                      "point": "A String",
                    },
                    "adherenceRubric": {
                      "isAddressed": True or False,
                      "question": "A String",
                      "reasoning": "A String",
                    },
                    "completenessRubric": {
                      "isAddressed": True or False,
                      "question": "A String",
                    },
                  },
                ],
                "score": 3.14,
                "section": "A String",
                "sectionSummary": "A String",
              },
            ],
          },
        ],
        "sectionTokens": [
          {
            "section": "A String",
            "tokenCount": "A String",
          },
        ],
        "summarySections": [
          {
            "section": "A String",
            "summary": "A String",
          },
        ],
      },
    ],
    "overallMetrics": [
      {
        "metric": "A String",
      },
    ],
    "overallSectionTokens": [
      {
        "section": "A String",
        "tokenCount": "A String",
      },
    ],
    "summarizationEvaluationMergedResultsUri": "A String",
    "summarizationEvaluationResults": [
      {
        "decompositions": [
          {
            "accuracyDecomposition": {
              "accuracyReasoning": "A String",
              "isAccurate": True or False,
              "point": "A String",
            },
            "adherenceDecomposition": {
              "adherenceReasoning": "A String",
              "isAdherent": True or False,
              "point": "A String",
            },
          },
        ],
        "evaluationResults": [
          {
            "accuracyDecomposition": {
              "accuracyReasoning": "A String",
              "isAccurate": True or False,
              "point": "A String",
            },
            "adherenceRubric": {
              "isAddressed": True or False,
              "question": "A String",
              "reasoning": "A String",
            },
            "completenessRubric": {
              "isAddressed": True or False,
              "question": "A String",
            },
          },
        ],
        "metric": "A String",
        "score": 3.14,
        "section": "A String",
        "sectionSummary": "A String",
        "sessionId": "A String",
      },
    ],
  },
}
list(parent, pageSize=None, pageToken=None, x__xgafv=None)

Args:
  parent: string, A parameter (required)
  pageSize: integer, A parameter
  pageToken: string, A parameter
  x__xgafv: string, V1 error format.
    Allowed values
      1 - v1 error format
      2 - v2 error format

Returns:
  An object of the form:

    {
  "generatorEvaluations": [
    {
      "completeTime": "A String",
      "createTime": "A String",
      "displayName": "A String",
      "evaluationStatus": {
        "done": True or False,
        "pipelineStatus": {
          "code": 42,
          "details": [
            {
              "a_key": "", # Properties of the object. Contains field @type with type URL.
            },
          ],
          "message": "A String",
        },
      },
      "generatorEvaluationConfig": {
        "inputDataConfig": {
          "agentAssistInputDataConfig": {
            "endTime": "A String",
            "startTime": "A String",
          },
          "datasetInputDataConfig": {
            "dataset": "A String",
          },
          "endTime": "A String",
          "inputDataSourceType": "A String",
          "isSummaryGenerationAllowed": True or False,
          "sampleSize": 42,
          "startTime": "A String",
          "summaryGenerationOption": "A String",
        },
        "outputGcsBucketPath": "A String",
        "summarizationConfig": {
          "accuracyEvaluationVersion": "A String",
          "completenessEvaluationVersion": "A String",
          "enableAccuracyEvaluation": True or False,
          "enableCompletenessEvaluation": True or False,
          "evaluatorVersion": "A String",
        },
      },
      "initialGenerator": {
        "agentCoachingContext": {
          "instructions": [
            {
              "agentAction": "A String",
              "condition": "A String",
              "displayDetails": "A String",
              "displayName": "A String",
              "duplicateCheckResult": {
                "duplicateSuggestions": [
                  {
                    "answerRecord": "A String",
                    "similarityScore": 3.14,
                    "suggestionIndex": 42,
                  },
                ],
              },
              "systemAction": "A String",
              "triggeringEvent": "A String",
            },
          ],
          "outputLanguageCode": "A String",
          "overarchingGuidance": "A String",
          "version": "A String",
        },
        "createTime": "A String",
        "description": "A String",
        "freeFormContext": {
          "text": "A String",
        },
        "inferenceParameter": {
          "maxOutputTokens": 42,
          "temperature": 3.14,
          "topK": 42,
          "topP": 3.14,
        },
        "name": "A String",
        "publishedModel": "A String",
        "suggestionDedupingConfig": {
          "enableDeduping": True or False,
          "similarityThreshold": 3.14,
        },
        "summarizationContext": {
          "fewShotExamples": [
            {
              "conversationContext": {
                "messageEntries": [
                  {
                    "createTime": "A String",
                    "languageCode": "A String",
                    "role": "A String",
                    "text": "A String",
                  },
                ],
              },
              "extraInfo": {
                "a_key": "A String",
              },
              "output": {
                "agentCoachingSuggestion": {
                  "agentActionSuggestions": [
                    {
                      "agentAction": "A String",
                      "duplicateCheckResult": {
                        "duplicateSuggestions": [
                          {
                            "answerRecord": "A String",
                            "similarityScore": 3.14,
                            "sources": {
                              "instructionIndexes": [
                                42,
                              ],
                            },
                            "suggestionIndex": 42,
                          },
                        ],
                      },
                      "sources": {
                        "instructionIndexes": [
                          42,
                        ],
                      },
                    },
                  ],
                  "applicableInstructions": [
                    {
                      "agentAction": "A String",
                      "condition": "A String",
                      "displayDetails": "A String",
                      "displayName": "A String",
                      "duplicateCheckResult": {
                        "duplicateSuggestions": [
                          {
                            "answerRecord": "A String",
                            "similarityScore": 3.14,
                            "suggestionIndex": 42,
                          },
                        ],
                      },
                      "systemAction": "A String",
                      "triggeringEvent": "A String",
                    },
                  ],
                  "sampleResponses": [
                    {
                      "duplicateCheckResult": {
                        "duplicateSuggestions": [
                          {
                            "answerRecord": "A String",
                            "similarityScore": 3.14,
                            "sources": {
                              "instructionIndexes": [
                                42,
                              ],
                            },
                            "suggestionIndex": 42,
                          },
                        ],
                      },
                      "responseText": "A String",
                      "sources": {
                        "instructionIndexes": [
                          42,
                        ],
                      },
                    },
                  ],
                },
                "freeFormSuggestion": {
                  "response": "A String",
                },
                "summarySuggestion": {
                  "summarySections": [
                    {
                      "section": "A String",
                      "summary": "A String",
                    },
                  ],
                },
                "toolCallInfo": [
                  {
                    "toolCall": {
                      "action": "A String",
                      "answerRecord": "A String",
                      "createTime": "A String",
                      "inputParameters": {
                        "a_key": "", # Properties of the object.
                      },
                      "state": "A String",
                      "tool": "A String",
                      "toolDisplayDetails": "A String",
                      "toolDisplayName": "A String",
                    },
                    "toolCallResult": {
                      "action": "A String",
                      "answerRecord": "A String",
                      "content": "A String",
                      "createTime": "A String",
                      "error": {
                        "message": "A String",
                      },
                      "rawContent": "A String",
                      "tool": "A String",
                    },
                  },
                ],
              },
              "summarizationSectionList": {
                "summarizationSections": [
                  {
                    "definition": "A String",
                    "key": "A String",
                    "type": "A String",
                  },
                ],
              },
            },
          ],
          "outputLanguageCode": "A String",
          "summarizationSections": [
            {
              "definition": "A String",
              "key": "A String",
              "type": "A String",
            },
          ],
          "version": "A String",
        },
        "tools": [
          "A String",
        ],
        "triggerEvent": "A String",
        "updateTime": "A String",
      },
      "name": "A String",
      "satisfiesPzi": True or False,
      "satisfiesPzs": True or False,
      "summarizationMetrics": {
        "conversationDetails": [
          {
            "messageEntries": [
              {
                "createTime": "A String",
                "languageCode": "A String",
                "role": "A String",
                "text": "A String",
              },
            ],
            "metricDetails": [
              {
                "metric": "A String",
                "score": 3.14,
                "sectionDetails": [
                  {
                    "evaluationResults": [
                      {
                        "accuracyDecomposition": {
                          "accuracyReasoning": "A String",
                          "isAccurate": True or False,
                          "point": "A String",
                        },
                        "adherenceRubric": {
                          "isAddressed": True or False,
                          "question": "A String",
                          "reasoning": "A String",
                        },
                        "completenessRubric": {
                          "isAddressed": True or False,
                          "question": "A String",
                        },
                      },
                    ],
                    "score": 3.14,
                    "section": "A String",
                    "sectionSummary": "A String",
                  },
                ],
              },
            ],
            "sectionTokens": [
              {
                "section": "A String",
                "tokenCount": "A String",
              },
            ],
            "summarySections": [
              {
                "section": "A String",
                "summary": "A String",
              },
            ],
          },
        ],
        "overallMetrics": [
          {
            "metric": "A String",
          },
        ],
        "overallSectionTokens": [
          {
            "section": "A String",
            "tokenCount": "A String",
          },
        ],
        "summarizationEvaluationMergedResultsUri": "A String",
        "summarizationEvaluationResults": [
          {
            "decompositions": [
              {
                "accuracyDecomposition": {
                  "accuracyReasoning": "A String",
                  "isAccurate": True or False,
                  "point": "A String",
                },
                "adherenceDecomposition": {
                  "adherenceReasoning": "A String",
                  "isAdherent": True or False,
                  "point": "A String",
                },
              },
            ],
            "evaluationResults": [
              {
                "accuracyDecomposition": {
                  "accuracyReasoning": "A String",
                  "isAccurate": True or False,
                  "point": "A String",
                },
                "adherenceRubric": {
                  "isAddressed": True or False,
                  "question": "A String",
                  "reasoning": "A String",
                },
                "completenessRubric": {
                  "isAddressed": True or False,
                  "question": "A String",
                },
              },
            ],
            "metric": "A String",
            "score": 3.14,
            "section": "A String",
            "sectionSummary": "A String",
            "sessionId": "A String",
          },
        ],
      },
    },
  ],
  "nextPageToken": "A String",
}
list_next()
Retrieves the next page of results.

        Args:
          previous_request: The request for the previous page. (required)
          previous_response: The response from the request for the previous page. (required)

        Returns:
          A request object that you can call 'execute()' on to request the next
          page. Returns None if there are no more items in the collection.