DataForSEO
SEO, search-engine results, keyword research, backlinks and AI visibility data.
Google My Business 질의응답 작업 생성
Google 비즈니스 프로필의 질문과 답변을 대기열에 넣고 작업 id를 반환합니다. DataForSEO 응답 봉투로 감싸집니다. 데이터는 tasks[0].result에, 결과는 tasks[0].status_code에 있으며, 거부된 요청도 여전히 HTTP 200을 반환합니다.
가격 참고
- 과금 기준: 응답에 보고된 비용.
- 참고 요청 추정치: USD 0.2428.
- 참고 고객 배수: 1.0. 이미 정산된 고객 금액에는 다시 적용하지 마세요.
참고용 메타데이터일 뿐이며, 계정 견적이나 보장된 가격, 지출 한도가 아닙니다. 리소스 크레딧은 Felo 크레딧이 아닙니다. 최종 청구는 Felo 청구 기록을 따릅니다.
- 유형: array (object | null)[]
- depth유형: integer | null
- keyword유형: string
키워드
필수 필드
지정하는 키워드는 지역 업체의 이름을 나타내야 합니다keyword필드에는 최대 700자까지 지정할 수 있습니다
모든 %##가 디코딩됩니다(‘+’ 문자는 공백 문자로 디코딩됨)keyword에 “%” 문자를 사용해야 하는 경우 “%25”로 지정하세요;이 필드는 다음 매개변수를 전달하는 데에도 사용할 수 있습니다:
cid- 비즈니스 엔티티의 고유한 Google 정의 id;place_id- Google Maps의 비즈니스 엔티티 식별자;예:
cid:194604053573767737place_id:GhIJQWDl0CIeQUARxks3icF8U8Acid및place_id식별자에 대한 자세한 내용은 이 도움말 센터 문서에서 확인하세요DataForSEO API의
keyword및keywords필드 규칙과 제한은 이 Help Center 문서에서 확인하세요 - language유형: string
_code 검색 엔진 언어 코드
language_name을 지정하지 않으면 필수 필드
이 필드를 사용하면language_name을 지정할 필요가 없습니다
사용 가능한 언어와 해당language_code목록은 다음 주소로 별도 요청해 받을 수 있습니다https://api.dataforseo.com/v3/business_data/google/languages
예:en - language유형: string
_name 검색 엔진 언어의 전체 이름
language_code를 지정하지 않으면 필수 필드
이 필드를 사용하면language_code를 지정할 필요가 없습니다
사용 가능한 언어와 해당language_name목록은 다음 주소로 별도 요청해 받을 수 있습니다https://api.dataforseo.com/v3/business_data/google/languages
예:English - location유형: integer
_code 검색 엔진 위치 코드
location_name또는location_coordinate를 지정하지 않은 경우 필수 필드입니다.
이 필드를 사용하면location_name또는location_coordinate를 지정할 필요가 없습니다.location_code별 사용 가능한 위치 목록은https://api.dataforseo.com/v3/business_data/google/locations에 별도 요청하여 받을 수 있습니다.
예:2840 - location유형: string
_coordinate 위치의 GPS 좌표
location_name또는location_code를 지정하지 않으면 필수 필드
이 필드를 사용하면location_name또는location_code를 지정할 필요가 없습니다location_coordinate매개변수는 "latitude,longitude,radius" 형식으로 지정해야 합니다
"latitude"와 "longitude"의 최대 소수 자릿수: 7
"radius"의 최솟값: 199.9(mm)
"radius"의 최댓값: 199999(mm)
예:53.476225,-2.243572,200 - location유형: string
_name 검색 엔진 위치의 전체 이름
location_code또는location_coordinate를 지정하지 않으면 필수 필드
이 필드를 사용하면location_code또는location_coordinate를 지정할 필요가 없습니다
사용 가능한 위치와 해당location_name목록은 다음 주소로 별도 요청해 받을 수 있습니다https://api.dataforseo.com/v3/business_data/google/locations
예:London,England,United Kingdom - pingback유형: string | null
_url 완료된 작업의 알림 URL
선택 필드
작업이 완료되면 지정한 URL로 GET 요청을 보내 알립니다
‘$id’ 문자열을$id변수로, ‘$tag’를 urlencoded$tag변수로 사용할 수 있습니다. 요청을 보내기 전에 필요한 값을 설정합니다.
예:http://your-server.com/pingscript?id=$idhttp://your-server.com/pingscript?id=$id&tag=$tag
참고:pingback_url의 특수 문자는 urlencoded됩니다;
즉,#문자는%23으로 인코딩됩니다
자세한 내용은 Help Center에서 확인하세요 - postback유형: string | null
_url 작업 결과를 보내는 URL
선택 필드
작업이 완료되면 결과를gzip형식으로 압축해 지정한postback_url로 POST 요청을 보냅니다
‘$id’ 문자열을$id변수로, ‘$tag’를 urlencoded$tag변수로 사용할 수 있습니다. 요청을 보내기 전에 필요한 값을 설정합니다.
예:http://your-server.com/postbackscript?id=$idhttp://your-server.com/postbackscript?id=$id&tag=$tag
참고:postback_url의 특수 문자는 urlencoded됩니다;
즉,#문자는%23으로 인코딩됩니다 - priority유형: integer | null
- tag유형: string | null
사용자 정의 작업 식별자
선택 필드
최대 255자
이 매개변수를 사용해 작업을 식별하고 결과와 매칭할 수 있습니다tag에 지정한 값은 응답의data객체에서 확인할 수 있습니다
- 유형: object | null · Response36Afe1097B20_BusinessDataGoogleQuestionsAndAnswersTaskPostResponseInfo200
- 유형: number | null 형식: doublecost
전체 작업 비용, USD
- 유형: integer | nullstatus
_code 일반 상태 코드입니다. 응답 코드 전체 목록은 여기에서 확인할 수 있습니다.
- 유형: string | nullstatus
_message 일반 정보 메시지입니다. 일반 정보 메시지 전체 목록은 여기에서 확인할 수 있습니다.
- 유형: array (object | null)[] | nulltasks
작업 배열
- 유형: object | null · Response36Afe1097B20_BusinessDataGoogleQuestionsAndAnswersTaskPostTaskInfo
- cost유형: number | null 형식: double
전체 작업 비용, USD
- data유형: object | null
POST 요청에 지정한 것과 동일한 매개변수를 포함합니다
- property유형: object | null
Name
- id유형: string | null
작업 식별자 시스템 내 고유 작업 식별자(UUID 형식)
- path유형: array (string | null)[] | null
URL 경로
- result유형: object | null
결과 배열
이 경우 값은null입니다 - result유형: integer | null 형식: int64
_count result 배열의 요소 수
- status유형: integer | null
_code 작업의 상태 코드 DataForSEO가 생성하며 10000-60000 범위일 수 있습니다. 응답 코드 전체 목록은 여기에서 확인할 수 있습니다.
- status유형: string | null
_message 작업의 정보 메시지 일반 정보 메시지 전체 목록은 여기에서 확인할 수 있습니다.
- time유형: string | null
실행 시간, 초
- 유형: integer | null 형식: int64tasks
_count tasks 배열의 작업 수
- 유형: integer | null 형식: int64tasks
_error 오류와 함께 반환된 tasks 배열의 작업 수
- 유형: string | nulltime
총 실행 시간(초)
- 유형: string | nullversion
API의 현재 버전
application/json - 400
요청을 처리할 수 없습니다. 요청 매개변수를 확인하세요.
- 401
유효한 Felo API 키가 필요합니다.
- 402
청구 요건이 충족되지 않아 요청을 진행할 수 없습니다.
- 403
이 계정에는 이 작업을 수행할 권한이 없습니다.
- 429
요청 또는 지출 한도에 도달했습니다.
- 502
서비스가 요청을 완료할 수 없습니다.
- 503
API 또는 청구 서비스를 일시적으로 사용할 수 없습니다.
- 504
요청을 처리하는 동안 서비스 시간이 초과되었습니다.
- default
오류 응답. 업스트림 패스스루 응답은 공급자 형식을 사용할 수 있습니다.
application/json
curl https://openapi.felo.ai/v1/beta/dataforseo/business_data/google/questions_and_answers/task_post \
--request POST \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
--data '[
{
"language_code": "en",
"location_name": "Los Angeles,California,United States",
"keyword": "The Last Bookstore"
}
]'
{
"version": null,
"status_code": null,
"status_message": null,
"time": null,
"cost": null,
"tasks_count": null,
"tasks_error": null,
"tasks": [
{
"id": null,
"status_code": null,
"status_message": null,
"time": null,
"cost": null,
"result_count": null,
"path": [
null
],
"data": null,
"result": null
}
]
}