v0.2.0-beta

OpenAPI 3.1.0

Tạo tác vụ thông tin Google My Business trực tiếp

Felo API Support

MIT

Máy chủ

https://openapi.felo.ai

Thư viện client

Shell Curl

DataForSEO

SEO, search-engine results, keyword research, backlinks and AI visibility data.

DataForSEO Thao tác

post/v1/beta/dataforseo/business_data/google/my_business_info/live

Tạo tác vụ thông tin Google My Business trực tiếp

Một Hồ sơ doanh nghiệp Google: tên, địa chỉ, điện thoại, giờ mở cửa, xếp hạng, danh mục và các thuộc tính Google hiển thị trên bảng. Được bọc trong envelope của DataForSEO: dữ liệu nằm trong tasks[0].result, kết quả trong tasks[0].status_code - yêu cầu bị từ chối vẫn trả về HTTP 200. Bản xếp hàng tương ứng là post_dataforseo_business_google_gmb_info_submit. Để xem những gì chủ doanh nghiệp đã đăng gần đây, dùng post_dataforseo_business_google_gmb_updates_submit, và để xem ý kiến khách hàng, dùng post_dataforseo_business_google_reviews_submit.

Tham chiếu giá

Cách tính: chi phí phản hồi được báo cáo.
Ước tính tham chiếu mỗi yêu cầu: 0,0054 USD.
Hệ số tham chiếu cho khách hàng: 1,0. Không áp dụng lại hệ số này cho số tiền khách hàng đã quyết toán.

Chỉ là siêu dữ liệu tham chiếu, không phải báo giá cho tài khoản, mức giá được bảo đảm hay hạn mức chi tiêu. Tín dụng tài nguyên không phải tín dụng Felo. Khoản phí cuối cùng tuân theo bản ghi thanh toán của Felo.

Phần thân

application/json

Kiểu: array (object | null)[]
- keyword
  Kiểu: string
  
  từ khóa
  trường bắt buộc
  từ khóa bạn chỉ định phải cho biết tên của cơ sở địa phương
  bạn có thể chỉ định tối đa 700 ký tự trong trường keyword
  mọi %## sẽ được giải mã (ký tự ‘+’ cũng sẽ được giải mã thành ký tự khoảng trắng)
  nếu bạn cần dùng ký tự “%” cho keyword, hãy chỉ định dưới dạng “%25”;
  
  trường này cũng có thể được dùng để truyền các tham số sau:
  cid - mã định danh duy nhất do Google xác định của thực thể doanh nghiệp;
  place_id - mã định danh của thực thể doanh nghiệp trong Google Maps;
  
  ví dụ:
  cid:194604053573767737
  place_id:GhIJQWDl0CIeQUARxks3icF8U8A
  
  tìm hiểu thêm về mã định danh cid và place_id tại bài viết Trung tâm trợ giúp này
  
  tìm hiểu thêm về quy tắc và giới hạn của các trường keyword và keywords trong API DataForSEO tại bài viết Trung tâm trợ giúp này
- language_code
  Kiểu: string
  
  mã ngôn ngữ của công cụ tìm kiếm
  trường bắt buộc nếu bạn không chỉ định language_name
  nếu bạn dùng trường này, bạn không cần chỉ định language_name
  bạn có thể nhận danh sách ngôn ngữ khả dụng cùng language_code của chúng bằng cách gửi một yêu cầu riêng đến https://api.dataforseo.com/v3/business_data/google/languages
  ví dụ:
  en
- language_name
  Kiểu: string
  
  tên đầy đủ của ngôn ngữ công cụ tìm kiếm
  trường bắt buộc nếu bạn không chỉ định language_code
  nếu bạn dùng trường này, bạn không cần chỉ định language_code
  bạn có thể nhận danh sách ngôn ngữ khả dụng với language_name bằng cách gửi một yêu cầu riêng đến https://api.dataforseo.com/v3/business_data/google/languages
  ví dụ:
  English
- location_code
  Kiểu: integer
  
  mã vị trí của công cụ tìm kiếm
  trường bắt buộc nếu bạn không chỉ định location_name hoặc location_coordinate
  nếu bạn dùng trường này, bạn không cần chỉ định location_name hoặc location_coordinate
  bạn có thể nhận danh sách vị trí khả dụng cùng location_code bằng cách gửi một yêu cầu riêng đến https://api.dataforseo.com/v3/business_data/google/locations
  ví dụ:
  2840
- location_coordinate
  Kiểu: string
  
  tọa độ GPS của một vị trí
  trường bắt buộc nếu bạn không chỉ định location_name hoặc location_code
  nếu bạn dùng trường này, bạn không cần chỉ định location_name hoặc location_code
  tham số location_coordinate phải được chỉ định ở định dạng "latitude,longitude,radius"
  số chữ số thập phân tối đa cho "latitude" và "longitude": 7
  giá trị tối thiểu cho "radius": 199.9 (mm)
  giá trị tối đa cho "radius": 199999 (mm)
  ví dụ:
  53.476225,-2.243572,200
- location_name
  Kiểu: string
  
  tên đầy đủ của vị trí công cụ tìm kiếm
  trường bắt buộc nếu bạn không chỉ định location_code hoặc location_coordinate
  nếu bạn dùng trường này, bạn không cần chỉ định location_code hoặc location_coordinate
  bạn có thể nhận danh sách vị trí khả dụng với location_name bằng cách gửi một yêu cầu riêng đến https://api.dataforseo.com/v3/business_data/google/locations
  ví dụ:
  London,England,United Kingdom
- tag
  Kiểu: string | null
  
  mã định danh tác vụ do người dùng xác định
  trường tùy chọn
  giới hạn ký tự là 255
  bạn có thể dùng tham số này để nhận diện tác vụ và khớp với kết quả
  bạn sẽ thấy giá trị tag đã chỉ định trong đối tượng data của phản hồi

Phản hồi

200
Kiểu: object | null · Response36Afe1097B20_BusinessDataGoogleMyBusinessInfoLiveResponseInfo
cost
Kiểu: number | null Định dạng: double

tổng chi phí tác vụ, USD

status_code
Kiểu: integer | null

mã trạng thái chung; bạn có thể tìm danh sách đầy đủ các mã phản hồi tại đây

status_message
Kiểu: string | null

thông điệp thông tin chung; bạn có thể tìm danh sách đầy đủ các thông điệp thông tin chung tại đây

tasks
Kiểu: array (object | null)[] | null

mảng tác vụ

Kiểu: object | null · Response36Afe1097B20_BusinessDataGoogleMyBusinessInfoLiveTaskInfo
cost
Kiểu: number | null Định dạng: double

tổng chi phí tác vụ, USD

data
Kiểu: object | null

chứa các tham số giống như bạn đã chỉ định trong yêu cầu POST

propertyName
Kiểu: object | null
id
Kiểu: string | null

mã định danh tác vụ; mã định danh tác vụ duy nhất trong hệ thống của chúng tôi ở định dạng UUID

path
Kiểu: array (string | null)[] | null

Đường dẫn URL

result
Kiểu: array (object | null)[] | null

mảng kết quả

check_url
Kiểu: string | null

URL trực tiếp đến kết quả công cụ tìm kiếm
bạn có thể dùng URL này để đảm bảo chúng tôi đã cung cấp kết quả chính xác

datetime
Kiểu: string | null

ngày và giờ nhận được kết quả
theo định dạng UTC: “yyyy-mm-dd hh-mm-ss +00:00”
ví dụ:
2019-11-15 12:57:46 +00:00

item_types
Kiểu: array (string | null)[] | null

các loại mục
các loại kết quả tìm kiếm gặp phải trong mảng items;
các loại mục khả dụng: google_business_info

items
Kiểu: array (object | null)[] | null

các loại mục gặp phải
các loại kết quả tìm kiếm gặp phải trong mảng items;
các loại mục khả dụng: google_business_info

additional_categories
Kiểu: array string[] | null

danh mục doanh nghiệp bổ sung
các danh mục Google My Business bổ sung mô tả dịch vụ do thực thể doanh nghiệp cung cấp chi tiết hơn

address
Kiểu: string | null

địa chỉ của thực thể doanh nghiệp

address_info
Kiểu: object | null · Response36Afe1097B20_AddressInfo

đối tượng chứa các thành phần địa chỉ của thực thể doanh nghiệp

address
Kiểu: string | null

địa chỉ đường phố của cơ sở địa phương

borough
Kiểu: string | null

đơn vị hành chính hoặc quận mà cơ sở địa phương trực thuộc

city
Kiểu: string | null

tên thành phố nơi cơ sở địa phương tọa lạc

country_code
Kiểu: string | null

mã quốc gia ISO của cơ sở địa phương

region
Kiểu: string | null

vùng DMA mà cơ sở địa phương trực thuộc

zip
Kiểu: string | null

mã ZIP của cơ sở địa phương

attributes
Kiểu: object | null · Response36Afe1097B20_BusinessDataAttributesInfo

chi tiết dịch vụ dưới dạng các mục kiểm tra do người dùng đánh giá;
chi tiết dịch vụ của một thực thể doanh nghiệp được hiển thị dưới dạng các mục kiểm tra và dựa trên phản hồi của người dùng cùng category của doanh nghiệp

available_attributes
Kiểu: object | null

thuộc tính khả dụng
cho biết các thuộc tính mà thực thể doanh nghiệp có thể cung cấp

propertyName
Kiểu: array (string | null)[] | null
unavailable_attributes
Kiểu: object | null

thuộc tính không khả dụng
cho biết các thuộc tính mà thực thể doanh nghiệp không thể cung cấp

propertyName
Kiểu: array (string | null)[] | null
book_online_url
Kiểu: string | null

URL trong nút 'book online' của phần tử
URL đưa người dùng đến trang đặt chỗ hoặc đặt hàng trực tuyến của thực thể doanh nghiệp

category
Kiểu: string | null

danh mục doanh nghiệp
danh mục chung trên Google My Business mô tả rõ nhất dịch vụ do thực thể doanh nghiệp cung cấp

category_ids
Kiểu: array string[] | null

ID danh mục toàn cầu
ID danh mục phổ quát không thay đổi theo quốc gia được chọn

cid
Kiểu: string | null

id khách hàng do google xác định
id duy nhất của một cơ sở địa phương;
có thể dùng với Google Reviews API để lấy danh sách đầy đủ các đánh giá
tìm hiểu thêm về mã định danh trong bài viết trung tâm trợ giúp này

contact_url
Kiểu: string | null

URL của trang liên hệ ưu tiên

contributor_url
Kiểu: string | null

URL hồ sơ Local Guides của người dùng hoặc thực thể, nếu có

description
Kiểu: string | null

mô tả của phần tử trong SERP
mô tả của thực thể doanh nghiệp mà kết quả được thu thập cho

directory
Kiểu: object | null · Response36Afe1097B20_BusinessDirectoryInfo

các mục của thư mục
bao gồm thông tin về các doanh nghiệp nằm trong cơ sở kinh doanh mục tiêu và có cùng địa chỉ

items
Kiểu: array (object | null)[] | null

các loại mục gặp phải
các loại kết quả tìm kiếm gặp phải trong mảng items;
các loại mục khả dụng: google_business_info

additional_categories
Kiểu: array string[] | null

danh mục doanh nghiệp bổ sung
các danh mục Google My Business bổ sung mô tả dịch vụ do thực thể doanh nghiệp cung cấp chi tiết hơn

address
Kiểu: string | null

địa chỉ của thực thể doanh nghiệp

address_info
Kiểu: object | null · Response36Afe1097B20_AddressInfo

đối tượng chứa các thành phần địa chỉ của thực thể doanh nghiệp

address
Kiểu: string | null

địa chỉ đường phố của cơ sở địa phương

borough
Kiểu: string | null

đơn vị hành chính hoặc quận mà cơ sở địa phương trực thuộc

city
Kiểu: string | null

tên thành phố nơi cơ sở địa phương tọa lạc

country_code
Kiểu: string | null

mã quốc gia ISO của cơ sở địa phương

region
Kiểu: string | null

vùng DMA mà cơ sở địa phương trực thuộc

zip
Kiểu: string | null

mã ZIP của cơ sở địa phương

category
Kiểu: string | null

danh mục doanh nghiệp
danh mục chung trên Google My Business mô tả rõ nhất dịch vụ do thực thể doanh nghiệp cung cấp

category_ids
Kiểu: array string[] | null

ID danh mục toàn cầu
ID danh mục phổ quát không thay đổi theo quốc gia được chọn

cid
Kiểu: string | null

id khách hàng do google xác định
id duy nhất của một cơ sở địa phương;
có thể dùng với Google Reviews API để lấy danh sách đầy đủ các đánh giá
tìm hiểu thêm về mã định danh trong bài viết trung tâm trợ giúp này

domain
Kiểu: string | null

tên miền của thực thể doanh nghiệp

feature_id
Kiểu: string | null

mã định danh duy nhất của phần tử trong SERP
tìm hiểu thêm về mã định danh trong bài viết trung tâm trợ giúp này

hotel_rating
Kiểu: string | null

xếp hạng cấp khách sạn
xếp hạng cấp nằm trong khoảng 1-5 sao, tìm hiểu thêm
nếu không có thông tin xếp hạng cấp khách sạn, giá trị sẽ là null

is_claimed
Kiểu: boolean | null

cho biết thực thể có được chủ sở hữu xác minh trên Google Maps hay không

is_directory_item
Kiểu: boolean | null

cơ sở kinh doanh là một phần của thư mục
cho biết cơ sở kinh doanh có phải là một phần của thư mục hay không;
nếu true, mục này là một phần của thư mục doanh nghiệp lớn hơn có cùng địa chỉ (ví dụ: một trung tâm thương mại hoặc trung tâm doanh nghiệp);
lưu ý: nếu cơ sở kinh doanh là mục gốc trong thư mục, giá trị sẽ là null

latitude
Kiểu: number | null

tọa độ vĩ độ của các cơ sở địa phương trên Google Maps
ví dụ:
"latitude": 51.584091

local_justifications
Kiểu: array string[] | null

lý do cục bộ của Google
các đoạn văn bản “giải thích” lý do doanh nghiệp xuất hiện cho truy vấn tìm kiếm

longitude
Kiểu: number | null

tọa độ kinh độ của cơ sở địa phương trên Google Maps
ví dụ:
"longitude": -0.31365919999999997

main_image
Kiểu: string | null

URL của hình ảnh chính trong hồ sơ Google My Business

phone
Kiểu: string | null

số điện thoại của thực thể doanh nghiệp

place_id
Kiểu: string | null

mã định danh địa điểm duy nhất
place id của cơ sở địa phương xuất hiện trong phần tử
tìm hiểu thêm về mã định danh trong bài viết trung tâm trợ giúp này

price_level
Kiểu: string | null

mức giá của cơ sở
có thể nhận các giá trị: inexpensive, moderate, expensive, very_expensive
nếu không có thông tin mức giá, giá trị sẽ là null

rank_absolute
Kiểu: integer | null

thứ hạng tuyệt đối trong tất cả các phần tử

rank_group
Kiểu: integer | null

vị trí trong một nhóm các phần tử có cùng giá trị type
vị trí của các phần tử có giá trị type khác bị bỏ qua khỏi rank_group

rating
Kiểu: object | null · Response36Afe1097B20_RatingInfo

xếp hạng của phần tử
mức độ phổ biến dựa trên đánh giá và được hiển thị trong SERP

rating_max
Kiểu: integer | null

giá trị tối đa cho một rating_type

rating_type
Kiểu: string | null

loại xếp hạng tại đây bạn có thể tìm thấy các phần tử sau: Max5, Percents, CustomMax

value
Kiểu: number | null Định dạng: double

giá trị của xếp hạng

votes_count
Kiểu: integer | null Định dạng: int64

số lượng phản hồi

rating_distribution
Kiểu: object | null

phân bố xếp hạng của thực thể doanh nghiệp đối tượng hiển thị số xếp hạng từ 1 sao đến 5 sao do người dùng đánh giá

propertyName
Kiểu: integer | null Định dạng: Int64
snippet
Kiểu: string | null

thông tin bổ sung về thực thể doanh nghiệp

title
Kiểu: string | null

tiêu đề thư mục
có thể nhận các giá trị sau: At this place, Directory

total_photos
Kiểu: string | null Định dạng: int64

tổng số hình ảnh trong hồ sơ Google My Business

type
Kiểu: string | null

loại phần tử

url
Kiểu: string | null

URL để xem thực đơn

work_hours
Kiểu: object | null · Response36Afe1097B20_BusinessWorkHoursInfo

giờ mở cửa
thông tin về giờ làm việc của cơ sở địa phương

work_hours
Kiểu: object | null · Response36Afe1097B20_WorkHours

giờ mở cửa
thông tin về giờ làm việc của cơ sở địa phương

current_status
Kiểu: string | null

trạng thái hiện tại của cơ sở
cho biết cơ sở đang mở hay đã đóng

timetable
Kiểu: object | null

thời gian biểu giờ làm việc

propertyName
Kiểu: array (object | null)[] | null

giờ làm việc vào Chủ nhật

close
Kiểu: object | null · Response36Afe1097B20_TimeInfo

giờ đóng cửa

hour
Kiểu: integer | null

giờ theo định dạng 24 giờ

minute
Kiểu: integer | null

phút

open
Kiểu: object | null · Response36Afe1097B20_TimeInfo

giờ mở cửa

hour
Kiểu: integer | null

giờ theo định dạng 24 giờ

minute
Kiểu: integer | null

phút

title
Kiểu: string | null

tiêu đề của phần tử
tên miền của hệ thống thực đơn trực tuyến

domain
Kiểu: string | null

tên miền của thực thể doanh nghiệp

feature_id
Kiểu: string | null

mã định danh duy nhất của phần tử trong SERP
tìm hiểu thêm về mã định danh trong bài viết trung tâm trợ giúp này

hotel_rating
Kiểu: number | null

xếp hạng cấp khách sạn
xếp hạng cấp nằm trong khoảng 1-5 sao, tìm hiểu thêm
nếu không có thông tin xếp hạng cấp khách sạn, giá trị sẽ là null

is_claimed
Kiểu: boolean | null

cho biết thực thể có được chủ sở hữu xác minh trên Google Maps hay không

is_directory_item
Kiểu: boolean | null

cơ sở kinh doanh là một phần của thư mục
cho biết cơ sở kinh doanh có phải là một phần của thư mục hay không;
nếu true, mục này là một phần của thư mục doanh nghiệp lớn hơn có cùng địa chỉ (ví dụ: một trung tâm thương mại hoặc trung tâm doanh nghiệp);
lưu ý: nếu cơ sở kinh doanh là mục gốc trong thư mục, giá trị sẽ là null

latitude
Kiểu: number | null

tọa độ vĩ độ của các cơ sở địa phương trên Google Maps
ví dụ:
"latitude": 51.584091

local_business_links
Kiểu: array (object | null)[] | null

các tương tác có sẵn với doanh nghiệp
danh sách các tùy chọn để tương tác với doanh nghiệp trực tiếp từ kết quả tìm kiếm

type
Kiểu: string | null

loại phần tử

logo
Kiểu: string | null

URL của logo xuất hiện trong hồ sơ Google My Business

longitude
Kiểu: number | null

tọa độ kinh độ của cơ sở địa phương trên Google Maps
ví dụ:
"longitude": -0.31365919999999997

main_image
Kiểu: string | null

URL của hình ảnh chính trong hồ sơ Google My Business

original_title
Kiểu: string | null

tiêu đề gốc của phần tử
tiêu đề gốc không được Google dịch

people_also_search
Kiểu: array (object | null)[] | null

các thực thể doanh nghiệp liên quan

cid
Kiểu: string | null

client id do Google xác định
id duy nhất của một cơ sở địa phương
tìm hiểu thêm về mã định danh trong bài viết trung tâm trợ giúp này

feature_id
Kiểu: string | null

mã định danh duy nhất của phần tử trong SERP
tìm hiểu thêm về mã định danh trong bài viết trung tâm trợ giúp này

rating
Kiểu: object | null · Response36Afe1097B20_RatingInfo

xếp hạng của phần tử
mức độ phổ biến dựa trên đánh giá và được hiển thị trong SERP

rating_max
Kiểu: integer | null

giá trị tối đa cho một rating_type

rating_type
Kiểu: string | null

loại xếp hạng tại đây bạn có thể tìm thấy các phần tử sau: Max5, Percents, CustomMax

value
Kiểu: number | null Định dạng: double

giá trị của xếp hạng

votes_count
Kiểu: integer | null Định dạng: int64

số lượng phản hồi

title
Kiểu: string | null

tiêu đề của phần tử trong SERP
tên của thực thể doanh nghiệp mà kết quả được thu thập

phone
Kiểu: string | null

số điện thoại của thực thể doanh nghiệp

place_id
Kiểu: string | null

mã định danh địa điểm duy nhất
place id của cơ sở địa phương xuất hiện trong phần tử
tìm hiểu thêm về mã định danh trong bài viết trung tâm trợ giúp này

place_topics
Kiểu: object | null

từ khóa được nhắc đến trong đánh giá của khách hàng
chứa các từ khóa phổ biến nhất liên quan đến sản phẩm/dịch vụ được nhắc trong đánh giá của khách hàng về một thực thể doanh nghiệp và số lượng đánh giá nhắc đến từng từ khóa
ví dụ:"place_topics": { "egg roll": 48, "birthday": 33 }

propertyName
Kiểu: integer | null Định dạng: int64

Signed 64-bit integers (long type).

popular_times
Kiểu: object | null · Response36Afe1097B20_PopularTimes

giờ cao điểm
thông tin về các khung giờ đông khách của thực thể doanh nghiệp

popular_times_by_days
Kiểu: object | null

giờ cao điểm
thông tin về các giờ bận rộn của cơ sở địa phương trong từng ngày của tuần

propertyName
Kiểu: array (object | null)[] | null

giờ làm việc vào Chủ nhật

popular_index
Kiểu: integer | null

chỉ số phổ biến chỉ số phổ biến theo thời gian tương đối, đo từ 0 đến 100; giá trị cao hơn tương ứng với thời điểm bận rộn hơn trong ngày

time
Kiểu: object | null · Response36Afe1097B20_TimeInfo

giờ theo định dạng 24 giờ

hour
Kiểu: integer | null

giờ theo định dạng 24 giờ

minute
Kiểu: integer | null

phút

position
Kiểu: string | null

căn lề trong SERP

price_level
Kiểu: string | null

mức giá của cơ sở
có thể nhận các giá trị: inexpensive, moderate, expensive, very_expensive
nếu không có thông tin mức giá, giá trị sẽ là null

questions_and_answers_count
Kiểu: integer | null

Integer numbers.

rank_absolute
Kiểu: integer | null

thứ hạng tuyệt đối trong tất cả các phần tử

rank_group
Kiểu: integer | null

vị trí trong một nhóm phần tử có cùng giá trị type
vị trí của các phần tử có giá trị type khác nhau bị bỏ khỏi rank_group

rating
Kiểu: object | null · Response36Afe1097B20_RatingInfo

xếp hạng của phần tử
mức độ phổ biến dựa trên đánh giá và được hiển thị trong SERP

rating_max
Kiểu: integer | null

giá trị tối đa cho một rating_type

rating_type
Kiểu: string | null

loại xếp hạng tại đây bạn có thể tìm thấy các phần tử sau: Max5, Percents, CustomMax

value
Kiểu: number | null Định dạng: double

giá trị của xếp hạng

votes_count
Kiểu: integer | null Định dạng: int64

số lượng phản hồi

rating_distribution
Kiểu: object | null

phân bố xếp hạng của thực thể doanh nghiệp
đối tượng hiển thị số xếp hạng từ 1 sao đến 5 sao theo đánh giá của người dùng

propertyName
Kiểu: integer | null Định dạng: Int64
services
Kiểu: array (object | null)[] | null

danh sách dịch vụ do doanh nghiệp cung cấp

category
Kiểu: string | null

danh mục doanh nghiệp
danh mục chung trên Google My Business mô tả rõ nhất dịch vụ do thực thể doanh nghiệp cung cấp

price
Kiểu: object | null · Response36Afe1097B20_PriceInfo
currency
Kiểu: string | null

loại tiền của giá được niêm yết mã ISO của loại tiền áp dụng cho giá

current
Kiểu: number | null Định dạng: double

giá hiện tại cho biết giá hiện tại của sản phẩm hoặc dịch vụ trong kết quả

displayed_price
Kiểu: string | null

chuỗi giá trong kết quả chuỗi giá thô như được cung cấp trong kết quả

is_price_range
Kiểu: boolean | null

giá được cung cấp dưới dạng khoảng cho biết giá có được cung cấp dưới dạng khoảng hay không

max_value
Kiểu: number | null Định dạng: double

giá tối đa giá tối đa của sản phẩm hoặc dịch vụ như được nêu trong kết quả

regular
Kiểu: number | null Định dạng: double

giá thường giá thường của sản phẩm hoặc dịch vụ khi không áp dụng giảm giá

snippet
Kiểu: string | null

thông tin bổ sung về thực thể doanh nghiệp

title
Kiểu: string | null

tiêu đề của phần tử trong SERP
tên của thực thể doanh nghiệp mà kết quả được thu thập

snippet
Kiểu: string | null

thông tin bổ sung về thực thể doanh nghiệp

title
Kiểu: string | null

tiêu đề của phần tử trong SERP
tên của thực thể doanh nghiệp mà kết quả được thu thập

total_photos
Kiểu: integer | null Định dạng: int64

tổng số hình ảnh trong hồ sơ Google My Business

type
Kiểu: string | null

loại phần tử

url
Kiểu: string | null

url tuyệt đối của thực thể doanh nghiệp

work_time
Kiểu: object | null · Response36Afe1097B20_BusinessWorkHoursInfo

chi tiết giờ làm việc
thông tin về giờ hoạt động của thực thể doanh nghiệp

work_hours
Kiểu: object | null · Response36Afe1097B20_WorkHours

giờ mở cửa
thông tin về giờ làm việc của cơ sở địa phương

current_status
Kiểu: string | null

trạng thái hiện tại của cơ sở
cho biết cơ sở đang mở hay đã đóng

timetable
Kiểu: object | null

thời gian biểu giờ làm việc

propertyName
Kiểu: array (object | null)[] | null

giờ làm việc vào Chủ nhật

close
Kiểu: object | null · Response36Afe1097B20_TimeInfo

giờ đóng cửa

hour
Kiểu: integer | null

giờ theo định dạng 24 giờ

minute
Kiểu: integer | null

phút

open
Kiểu: object | null · Response36Afe1097B20_TimeInfo

giờ mở cửa

hour
Kiểu: integer | null

giờ theo định dạng 24 giờ

minute
Kiểu: integer | null

phút

items_count
Kiểu: integer | null Định dạng: int64

các loại mục
số lượng mục trong mảng items

keyword
Kiểu: string | null

từ khóa nhận được trong mảng POST
từ khóa được trả về với %## đã giải mã (ký tự cộng '+' sẽ được giải mã thành dấu cách)
trường này sẽ chứa tham số cid nếu bạn đã chỉ định nó trong trường keyword khi tạo tác vụ;
ví dụ:
cid:2946633002421908862
tìm hiểu thêm về tham số trong bài viết trung tâm trợ giúp này

language_code
Kiểu: string | null

mã ngôn ngữ trong mảng POST

location_code
Kiểu: integer | null

mã vị trí trong mảng POST

se_domain
Kiểu: string | null

tên miền công cụ tìm kiếm như được chỉ định trong mảng POST

result_count
Kiểu: integer | null Định dạng: int64

số phần tử trong mảng kết quả

status_code
Kiểu: integer | null

mã trạng thái của tác vụ do DataForSEO tạo; có thể nằm trong khoảng sau: 10000-60000; bạn có thể tìm danh sách đầy đủ các mã phản hồi tại đây

status_message
Kiểu: string | null

thông điệp thông tin của tác vụ; bạn có thể tìm danh sách đầy đủ các thông điệp thông tin chung tại đây

time
Kiểu: string | null

thời gian thực thi, giây

tasks_count
Kiểu: integer | null Định dạng: int64

số lượng tác vụ trong mảng tasks

tasks_error
Kiểu: integer | null Định dạng: int64

số lượng tác vụ trong mảng tasks được trả về kèm lỗi

time
Kiểu: string | null

tổng thời gian thực thi, giây

version
Kiểu: string | null

phiên bản hiện tại của API
application/json
400

Không thể xử lý yêu cầu. Hãy kiểm tra các tham số yêu cầu.
401

Cần có khóa API Felo hợp lệ.
402

Không thể tiếp tục yêu cầu vì chưa đáp ứng yêu cầu thanh toán.
403

Tài khoản không được phép thực hiện thao tác này.
429

Đã đạt giới hạn yêu cầu hoặc giới hạn chi tiêu.
502

Dịch vụ không thể hoàn tất yêu cầu.
503

API hoặc dịch vụ thanh toán tạm thời không khả dụng.
504

Dịch vụ đã hết thời gian chờ khi xử lý yêu cầu.
default

Phản hồi lỗi; phản hồi chuyển tiếp từ thượng nguồn có thể dùng định dạng của nhà cung cấp

application/json

post/v1/beta/dataforseo/business_data/google/my_business_info/live

curl https://openapi.felo.ai/v1/beta/dataforseo/business_data/google/my_business_info/live \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '[
  {
    "language_code": "en",
    "location_name": "New York,New York,United States",
    "keyword": "RustyBrick, Inc."
  }
]'

Hiện schema

{
  "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": [
        {
          "keyword": null,
          "se_domain": null,
          "location_code": null,
          "language_code": null,
          "check_url": null,
          "datetime": null,
          "item_types": [
            null
          ],
          "items_count": null,
          "items": [
            {
              "type": null,
              "rank_group": null,
              "rank_absolute": null,
              "position": null,
              "title": null,
              "original_title": null,
              "description": null,
              "category": null,
              "category_ids": [
                "[Max Depth Exceeded]"
              ],
              "additional_categories": [
                "[Max Depth Exceeded]"
              ],
              "cid": null,
              "feature_id": null,
              "address": null,
              "address_info": "[Max Depth Exceeded]",
              "place_id": null,
              "phone": null,
              "url": null,
              "contact_url": null,
              "contributor_url": null,
              "book_online_url": null,
              "domain": null,
              "logo": null,
              "main_image": null,
              "total_photos": null,
              "snippet": null,
              "latitude": null,
              "longitude": null,
              "is_claimed": null,
              "questions_and_answers_count": null,
              "attributes": "[Max Depth Exceeded]",
              "place_topics": null,
              "rating": "[Max Depth Exceeded]",
              "hotel_rating": null,
              "price_level": null,
              "rating_distribution": null,
              "people_also_search": [
                "[Max Depth Exceeded]"
              ],
              "work_time": "[Max Depth Exceeded]",
              "popular_times": "[Max Depth Exceeded]",
              "local_business_links": [
                "[Max Depth Exceeded]"
              ],
              "is_directory_item": null,
              "directory": "[Max Depth Exceeded]",
              "services": [
                "[Max Depth Exceeded]"
              ]
            }
          ]
        }
      ]
    }
  ]
}

Thao tác thành công

Tạo tác vụ thông tin Google My Business trực tiếp

Xác thựcRequired

DataForSEO

Tạo tác vụ thông tin Google My Business trực tiếp

Tham chiếu giá