My Business Q&A API . locations . questions

Instance Methods

answers()

Returns the answers Resource.

close()

Close httplib2 connections.

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

Adds a question for the specified location.

delete(name, x__xgafv=None)

Deletes a specific question written by the current user.

list(parent, answersPerQuestion=None, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Returns the paginated list of questions and some of its answers for a specified location. This operation is only valid if the specified location is verified.

list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

Updates a specific question written by the current user.

Method Details

close()
Close httplib2 connections.
create(parent, body=None, x__xgafv=None)
Adds a question for the specified location.

Args:
  parent: string, Required. The name of the location to write a question for. (required)
  body: object, The request body.
    The object takes the form of:

{ # Represents a single question and some of its answers.
  "author": { # Represents the author of a question or answer # Output only. The author of the question.
    "displayName": "A String", # The display name of the user
    "profilePhotoUri": "A String", # The profile photo URI of the user.
    "type": "A String", # The type of user the author is.
  },
  "createTime": "A String", # Output only. The timestamp for when the question was written.
  "name": "A String", # Immutable. The unique name for the question. locations/*/questions/* This field will be ignored if set during question creation.
  "text": "A String", # Required. The text of the question. It should contain at least three words and the total length should be greater than or equal to 10 characters. The maximum length is 4096 characters.
  "topAnswers": [ # Output only. A list of answers to the question, sorted by upvotes. This may not be a complete list of answers depending on the request parameters (answers_per_question)
    { # Represents an answer to a question
      "author": { # Represents the author of a question or answer # Output only. The author of the answer. Will only be set during list operations.
        "displayName": "A String", # The display name of the user
        "profilePhotoUri": "A String", # The profile photo URI of the user.
        "type": "A String", # The type of user the author is.
      },
      "createTime": "A String", # Output only. The timestamp for when the answer was written. Only retrieved during ListResponse fetching.
      "name": "A String", # Output only. The unique name for the answer locations/*/questions/*/answers/*
      "text": "A String", # Required. The text of the answer. It should contain at least one non-whitespace character. The maximum length is 4096 characters.
      "updateTime": "A String", # Output only. The timestamp for when the answer was last modified.
      "upvoteCount": 42, # Output only. The number of upvotes for the answer.
    },
  ],
  "totalAnswerCount": 42, # Output only. The total number of answers posted for this question.
  "updateTime": "A String", # Output only. The timestamp for when the question was last modified.
  "upvoteCount": 42, # Output only. The number of upvotes for the question.
}

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

Returns:
  An object of the form:

    { # Represents a single question and some of its answers.
  "author": { # Represents the author of a question or answer # Output only. The author of the question.
    "displayName": "A String", # The display name of the user
    "profilePhotoUri": "A String", # The profile photo URI of the user.
    "type": "A String", # The type of user the author is.
  },
  "createTime": "A String", # Output only. The timestamp for when the question was written.
  "name": "A String", # Immutable. The unique name for the question. locations/*/questions/* This field will be ignored if set during question creation.
  "text": "A String", # Required. The text of the question. It should contain at least three words and the total length should be greater than or equal to 10 characters. The maximum length is 4096 characters.
  "topAnswers": [ # Output only. A list of answers to the question, sorted by upvotes. This may not be a complete list of answers depending on the request parameters (answers_per_question)
    { # Represents an answer to a question
      "author": { # Represents the author of a question or answer # Output only. The author of the answer. Will only be set during list operations.
        "displayName": "A String", # The display name of the user
        "profilePhotoUri": "A String", # The profile photo URI of the user.
        "type": "A String", # The type of user the author is.
      },
      "createTime": "A String", # Output only. The timestamp for when the answer was written. Only retrieved during ListResponse fetching.
      "name": "A String", # Output only. The unique name for the answer locations/*/questions/*/answers/*
      "text": "A String", # Required. The text of the answer. It should contain at least one non-whitespace character. The maximum length is 4096 characters.
      "updateTime": "A String", # Output only. The timestamp for when the answer was last modified.
      "upvoteCount": 42, # Output only. The number of upvotes for the answer.
    },
  ],
  "totalAnswerCount": 42, # Output only. The total number of answers posted for this question.
  "updateTime": "A String", # Output only. The timestamp for when the question was last modified.
  "upvoteCount": 42, # Output only. The number of upvotes for the question.
}
delete(name, x__xgafv=None)
Deletes a specific question written by the current user.

Args:
  name: string, Required. The name of the question to delete. (required)
  x__xgafv: string, V1 error format.
    Allowed values
      1 - v1 error format
      2 - v2 error format

Returns:
  An object of the form:

    { # A generic empty message that you can re-use to avoid defining duplicated empty messages in your APIs. A typical example is to use it as the request or the response type of an API method. For instance: service Foo { rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty); }
}
list(parent, answersPerQuestion=None, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)
Returns the paginated list of questions and some of its answers for a specified location. This operation is only valid if the specified location is verified.

Args:
  parent: string, Required. The name of the location to fetch questions for. (required)
  answersPerQuestion: integer, Optional. How many answers to fetch per question. The default and maximum `answers_per_question` values are 10.
  filter: string, Optional. A filter constraining the questions to return. The only filter currently supported is "ignore_answered=true"
  orderBy: string, Optional. The order to return the questions. Valid options include 'update_time desc' and 'upvote_count desc', which will return the questions sorted descendingly by the requested field. The default sort order is 'update_time desc'.
  pageSize: integer, Optional. How many questions to fetch per page. The default and maximum `page_size` values are 10.
  pageToken: string, Optional. If specified, the next page of questions is retrieved.
  x__xgafv: string, V1 error format.
    Allowed values
      1 - v1 error format
      2 - v2 error format

Returns:
  An object of the form:

    { # Response message for QuestionsAndAnswers.ListQuestions
  "nextPageToken": "A String", # If the number of questions exceeds the requested max page size, this field is populated with a token to fetch the next page of questions on a subsequent call. If there are no more questions, this field is not present in the response.
  "questions": [ # The requested questions,
    { # Represents a single question and some of its answers.
      "author": { # Represents the author of a question or answer # Output only. The author of the question.
        "displayName": "A String", # The display name of the user
        "profilePhotoUri": "A String", # The profile photo URI of the user.
        "type": "A String", # The type of user the author is.
      },
      "createTime": "A String", # Output only. The timestamp for when the question was written.
      "name": "A String", # Immutable. The unique name for the question. locations/*/questions/* This field will be ignored if set during question creation.
      "text": "A String", # Required. The text of the question. It should contain at least three words and the total length should be greater than or equal to 10 characters. The maximum length is 4096 characters.
      "topAnswers": [ # Output only. A list of answers to the question, sorted by upvotes. This may not be a complete list of answers depending on the request parameters (answers_per_question)
        { # Represents an answer to a question
          "author": { # Represents the author of a question or answer # Output only. The author of the answer. Will only be set during list operations.
            "displayName": "A String", # The display name of the user
            "profilePhotoUri": "A String", # The profile photo URI of the user.
            "type": "A String", # The type of user the author is.
          },
          "createTime": "A String", # Output only. The timestamp for when the answer was written. Only retrieved during ListResponse fetching.
          "name": "A String", # Output only. The unique name for the answer locations/*/questions/*/answers/*
          "text": "A String", # Required. The text of the answer. It should contain at least one non-whitespace character. The maximum length is 4096 characters.
          "updateTime": "A String", # Output only. The timestamp for when the answer was last modified.
          "upvoteCount": 42, # Output only. The number of upvotes for the answer.
        },
      ],
      "totalAnswerCount": 42, # Output only. The total number of answers posted for this question.
      "updateTime": "A String", # Output only. The timestamp for when the question was last modified.
      "upvoteCount": 42, # Output only. The number of upvotes for the question.
    },
  ],
  "totalSize": 42, # The total number of questions posted for this location across all pages.
}
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.
        
patch(name, body=None, updateMask=None, x__xgafv=None)
Updates a specific question written by the current user.

Args:
  name: string, Immutable. The unique name for the question. locations/*/questions/* This field will be ignored if set during question creation. (required)
  body: object, The request body.
    The object takes the form of:

{ # Represents a single question and some of its answers.
  "author": { # Represents the author of a question or answer # Output only. The author of the question.
    "displayName": "A String", # The display name of the user
    "profilePhotoUri": "A String", # The profile photo URI of the user.
    "type": "A String", # The type of user the author is.
  },
  "createTime": "A String", # Output only. The timestamp for when the question was written.
  "name": "A String", # Immutable. The unique name for the question. locations/*/questions/* This field will be ignored if set during question creation.
  "text": "A String", # Required. The text of the question. It should contain at least three words and the total length should be greater than or equal to 10 characters. The maximum length is 4096 characters.
  "topAnswers": [ # Output only. A list of answers to the question, sorted by upvotes. This may not be a complete list of answers depending on the request parameters (answers_per_question)
    { # Represents an answer to a question
      "author": { # Represents the author of a question or answer # Output only. The author of the answer. Will only be set during list operations.
        "displayName": "A String", # The display name of the user
        "profilePhotoUri": "A String", # The profile photo URI of the user.
        "type": "A String", # The type of user the author is.
      },
      "createTime": "A String", # Output only. The timestamp for when the answer was written. Only retrieved during ListResponse fetching.
      "name": "A String", # Output only. The unique name for the answer locations/*/questions/*/answers/*
      "text": "A String", # Required. The text of the answer. It should contain at least one non-whitespace character. The maximum length is 4096 characters.
      "updateTime": "A String", # Output only. The timestamp for when the answer was last modified.
      "upvoteCount": 42, # Output only. The number of upvotes for the answer.
    },
  ],
  "totalAnswerCount": 42, # Output only. The total number of answers posted for this question.
  "updateTime": "A String", # Output only. The timestamp for when the question was last modified.
  "upvoteCount": 42, # Output only. The number of upvotes for the question.
}

  updateMask: string, Required. The specific fields to update. Only question text can be updated.
  x__xgafv: string, V1 error format.
    Allowed values
      1 - v1 error format
      2 - v2 error format

Returns:
  An object of the form:

    { # Represents a single question and some of its answers.
  "author": { # Represents the author of a question or answer # Output only. The author of the question.
    "displayName": "A String", # The display name of the user
    "profilePhotoUri": "A String", # The profile photo URI of the user.
    "type": "A String", # The type of user the author is.
  },
  "createTime": "A String", # Output only. The timestamp for when the question was written.
  "name": "A String", # Immutable. The unique name for the question. locations/*/questions/* This field will be ignored if set during question creation.
  "text": "A String", # Required. The text of the question. It should contain at least three words and the total length should be greater than or equal to 10 characters. The maximum length is 4096 characters.
  "topAnswers": [ # Output only. A list of answers to the question, sorted by upvotes. This may not be a complete list of answers depending on the request parameters (answers_per_question)
    { # Represents an answer to a question
      "author": { # Represents the author of a question or answer # Output only. The author of the answer. Will only be set during list operations.
        "displayName": "A String", # The display name of the user
        "profilePhotoUri": "A String", # The profile photo URI of the user.
        "type": "A String", # The type of user the author is.
      },
      "createTime": "A String", # Output only. The timestamp for when the answer was written. Only retrieved during ListResponse fetching.
      "name": "A String", # Output only. The unique name for the answer locations/*/questions/*/answers/*
      "text": "A String", # Required. The text of the answer. It should contain at least one non-whitespace character. The maximum length is 4096 characters.
      "updateTime": "A String", # Output only. The timestamp for when the answer was last modified.
      "upvoteCount": 42, # Output only. The number of upvotes for the answer.
    },
  ],
  "totalAnswerCount": 42, # Output only. The total number of answers posted for this question.
  "updateTime": "A String", # Output only. The timestamp for when the question was last modified.
  "upvoteCount": 42, # Output only. The number of upvotes for the question.
}