Hello Google Ads API team,

In the REST documentation 
<https://developers.google.com/google-ads/api/rest/common/search> the 
following is written about the searchStream method:
*Note:* The results of a SearchStream API call are wrapped in a JSON array, 
whereas most other API calls return a single JSON object as the response 
message. See the JSON mappings 
<https://developers.google.com/google-ads/api/rest/design/json-mappings> 
section for more info.

The REST API is also documented in a machine-readable format in this 
discovery document:
https://googleads.googleapis.com/$discovery/rest?version=v7

These parts are about the searchStream method:
{
  "schemas": {
    "GoogleAdsGoogleadsV7Services__SearchGoogleAdsStreamResponse": {
      *"type": "object",*
      "properties": {
        "fieldMask": {
          "type": "string",
          "format": "google-fieldmask",
          "description": "FieldMask that represents what fields were 
requested by the user."
        },
        "requestId": {
          "type": "string",
          "description": "The unique id of the request that is used for 
debugging purposes."
        },
        "results": {
          "description": "The list of rows that matched the query.",
          "items": {
            "$ref": "GoogleAdsGoogleadsV7Services__GoogleAdsRow"
          },
          "type": "array"
        },
        "summaryRow": {
          "$ref": "GoogleAdsGoogleadsV7Services__GoogleAdsRow",
          "description": "Summary row that contains summary of metrics in 
results. Summary of metrics means aggregation of metrics across all 
results, here aggregation could be sum, average, rate, etc."
        }
      },
      "description": "Response message for GoogleAdsService.SearchStream.",
      "id": "GoogleAdsGoogleadsV7Services__SearchGoogleAdsStreamResponse"
    }
  },
  "resources": {
    "customers": {
      "resources": {
        "googleAds": {
          "methods": {
            "searchStream": {
              "parameterOrder": [
                "customerId"
              ],
              "flatPath": 
"v7/customers/{customersId}/googleAds:searchStream",
              "httpMethod": "POST",
              "description": "Returns all rows that match the search stream 
query. List of thrown errors: [AuthenticationError]() 
[AuthorizationError]() [ChangeEventError]() [ChangeStatusError]() 
[ClickViewError]() [HeaderError]() [InternalError]() [QueryError]() 
[QuotaError]() [RequestError]()",
              "request": {
                "$ref": 
"GoogleAdsGoogleadsV7Services__SearchGoogleAdsStreamRequest"
              },
              "scopes": [
                "https://www.googleapis.com/auth/adwords";
              ],
              "id": "googleads.customers.googleAds.searchStream",
              "parameters": {
                "customerId": {
                  "required": true,
                  "type": "string",
                  "location": "path",
                  "pattern": "^[^/]+$",
                  "description": "Required. The ID of the customer being 
queried."
                }
              },
              "response": {
                *"$ref": *
*"GoogleAdsGoogleadsV7Services__SearchGoogleAdsStreamResponse"*
              },
              "path": "v7/customers/{+customerId}/googleAds:searchStream"
            }
          }
        }
      }
    }
  }
}

In the discovery document the response type is an object, not an array. 
This generates an incorrect return type in the generated code.


Regards,
Menno

-- 
-- 
=~=~=~=~=~=~=~=~=~=~=~=~=~=~=~=~=~=~=~=~=~=~=~=~
Also find us on our blog:
https://googleadsdeveloper.blogspot.com/
=~=~=~=~=~=~=~=~=~=~=~=~=~=~=~=~=~=~=~=~=~=~=~=~

You received this message because you are subscribed to the Google
Groups "AdWords API and Google Ads API Forum" group.
To post to this group, send email to adwords-api@googlegroups.com
To unsubscribe from this group, send email to
adwords-api+unsubscr...@googlegroups.com
For more options, visit this group at
http://groups.google.com/group/adwords-api?hl=en
--- 
You received this message because you are subscribed to the Google Groups 
"AdWords API and Google Ads API Forum" group.
To unsubscribe from this group and stop receiving emails from it, send an email 
to adwords-api+unsubscr...@googlegroups.com.
To view this discussion on the web visit 
https://groups.google.com/d/msgid/adwords-api/e6b93cbf-5ad4-4aa2-80e8-496ce0cb0fedn%40googlegroups.com.

Reply via email to